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Slim 中 文 文档 


来 源 : Slim 中 文 文档 


此 处 的 文档 针对 Slim 3 。 要 查阅 Slim 2 的 文档 请 访问 docs.slimframework.com 。 


欢迎 使 用 


Slim 是 一 款 PHP 微 框架 ， 可 以 帮助 你 快速 编写 简单 但 功能 强大 的 web 应 用 和 API — 
核心 ，Slim 是 一 个 调度 程序 ， 它 接收 一 个 HTTP 请 求 ， 调 用 一 个 适当 的 回调 例 程 ， 然 后 返 
一 个 HTTP 响应 。 就 这 样 简单 。 


重点 是 什么 ? 


Slim 是 一 个 理想 的 工具 ， 用 来 创建 销毁 、 重 用 或 发 布 数据 。Slim 也 是 一 个 用 来 快速 构建 原型 
AJL o> AS > REE TULA Slim 来 创建 带 有 用 户 界 面 的 功能 完整 的 web 应 用 程序 。 
更 重要 的 是 ，Slim 速度 超 快 ， 代 码 很 简单 。 实 际 上 ， 一 个 下 午 你 就 能 读 完 并 理解 它 的 源 代 
码 | 


在 它 的 核心 ，Slim 是 一 个 调度 程序 ， 它 接收 一 个 HTTP 请 求 ， 调 用 一 个 适当 的 回调 例 
程 ， 然 后 返回 一 个 HTTP 响应 。 就 这 样 简单 。 


你 并 不 总 是 需要 一 套 全 方位 的 解决 方案 ， 上 比如 Symfony 或 者 Laravel 。 当 然 ， 它 们 都 是 了 不 
起 的 工具 。 但 它们 往往 矫 枉 过 正 。 相 反 ，Slim 只 最 小 限度 地 提供 你 所 需要 用 的 工具 ， 没 有 其 
多 余 的 东西 。 


它 如 何 工 作 ? 


首先 ， 你 需要 一 个 web 服务 器 ， 比 如 aos 或 Apache 。 你 需要 配置 你 的 web 服务 器 让 它 发 
送 所 有 适当 的 请 求 到 一 个 “前 端 控制 器 ” PHP 文件。 你 就 在 这 个 PHP 文件 里 实例 化 并 运行 你 的 
Slim 应 用 。 


一 个 Slim 应 用 包含 多 个 响应 特定 HTTP 请 求 的 路 由 。 每 个 路 由 调用 一 个 回调 并 返回 一 个 
HTTP 响应 。 在 刚 开 始 的 时 候 ， 你 首先 实例 Slim 应 用 。 下 一 步 ， 定 义 你 的 应 用 程序 
的 路 由 。 最 后 ， 运 行 你 的 Slim 应 用 程序 。 这 很 简单 吧 ? 这 里 有 一 个 实例 应 用 程序 : 


<?php 
// 创建 并 配置 Slim app $app = new \Slim\App; 


// 定义 app % $app->get('/hello/{name}', function ($request, $response, $args) { 


return $response->write("Hello " . $args['name']); 


3); 


// 运行 app $app->run(); 


Figure 1: Slim 示例 应 用 


请 求 和 响应 
当 你 构建 一 个 Slim 应 用 时 ， 你 会 经 常 直接 与 请 求 对 象 和 响应 对 象 打交道 。 这 些 对 象 表示 由 
web 服务 器 实际 接收 到 的 HTTP 请 求 ， 以 及 最 终 返 回 给 客户 端的 HTTP 响应。 


Slim 应 用 程序 的 每 个 路 由 都 将 前 的 请 求 对 $ fori 对 BMA 它 的 回调 例 程 的 参数 这 些 对 象 
实现 了 流行 的 PSR7 接口 。Slim 应 用 的 路 由 可 以 必要 地 检查 或 操作 这 些 对 象 。 最 终 ， 每 个 
Slim 应 用 路 由 必然 返回 一 个 PSR 7 响应 对 象 。 


加 入 你 自己 的 组 件 


Slim 可 以 良好 地 兼容 其 他 PHP 组 件 。 你 可 以 注册 第 三 方 组 件 ， 比 如 Slim-Csrf, Slim- 
HttpCache, 或 Slim-Flash 这 种 基于 Slim 默认 功能 上 的 组 件 。Slim 还 可 以 很 容易 地 集成 那些 
从 Packagist 上 找到 的 第 三 方 组 件 。 


如 何 阅 读 这 份 文档 


如 果 你 是 第 一 次 接触 Slim， 我 建议 你 从 头 到 尾 先 阅读 一 遍 。 如 果 你 已 经 和 Slim 混 得 比较 熟 
了 ， 你 可 以 直接 去 阅读 你 想 看 的 部 分 。 


本 文档 从 解释 Slim 的 概念 和 架构 开始 ， 而 不 是 贸然 开始 讲述 请 求 和 响应 处 理 、 路 由 、 错 误 处 
理 这 些 特定 的 话题 。 特 定 的 话题 。 (中 文 文档 若 有 错误 或 不 准确 ， 请 务必 反馈 一 下 哦 】) 


安装 


e 支持 URL 重 写 的 Web 服务 器 
© PHP 5.5.0 或 者 更 新 版 本 


如 何 安 装 Slim 


我 们 推荐 你 使 用 Composer 。 这 个 依赖 管理 器 来 安装 Slim 框架 。 在 你 的 项 目 根 目 录 中 ， 运 行 
以 下 bash 命令 7 将 最 新 的 稳定 版 安装 到 项 目的 vendors A RP 8 


composer require slim/slim "43.0" 
然后 ， 在 PHP BAY RA Composer 的 自动 加 载 器 ， 然 后 就 可 以 开始 使 用 Slim 了 。 


<?php 
require 'vendor/autoload.php'; 


如 何 安 装 Composer 
没有 Composer ?很 容易 安装 的 。 由 于 GFW 的 原因 ， 所 以 建议 使 用 国内 镜像 来 下 载 安 装 。 


2 


通过 Composer 镜像 安装 Composer 
首先 ， 务 必 确 保 已 经 正确 安装 了 PHP ° 
局 部 安装 


局 部 安装 是 将 composer 安装 到 当前 目录 下 面 (比如 安装 到 项 目 根 目录 下 ) ， 然 后 就 可 以 通 
过 php composer.phar 来 使 用 composer 了 。 


Mac 或 Linux 系统 : 打开 命令 行 窗口 并 执行 如 下 命令 : 


curl -SS http://install.phpcomposer.com/installer | php 


Windows 系统 (Mac 或 Linux 系统 也 可 以 使 用 ) : 请 执行 如 下 命令 : 


php -r "readfile('http://install.phpcomposer.com/installer');" | php 


升级 指南 


如 果 你 打算 从 Slim 2 升级 到 Slim 3， 这 里 有 一 些 重要 的 变化 ， 你 必须 清楚 。 


新 的 PHP 版 本 要 求 


Slim 3 要 求 PHP 5.5+ 


新 的 路 由 有 函数 签名 


$app->get('/', function (Request $req, Response $res, $args = []) { 
return $res->withStatus(400)->write('Bad Request'); 


3); 


获取 GET 和 POST 交 量 


$app->get('/', function (Request $req, Response $res, $args = []) { 
$myvar1 = $req->getParam('myvar'); // 检 查 _GET 和 _POST [不 遵循 PSR 7] 
$myvar2 = $req->getParsedBody()['myvar']; // 检 查 _POST [遵循 PSR 7] 
$myvar3 = $req->getQueryParams()['myvar']; // 检 查 _GET [遵循 PSR 7] 
}); 


44 F | Hooks 


Slim v3 不 再 有 钧 子 的 概念 。You should consider reimplementing any functionality 
associated with the default hooks in Slim v2 as middleware instead. If you need the ability to 
apply custom hooks at arbitrary points in your code (for example, within a route), you should 
consider a third-party package such as Symfony’s EventDispatcher or Zend Framework’s 
EventManager. 


移 除 HTTP 缓存 


在 Slim v3 我 们 将 HTTP 缓存 迁移 到 了 单独 的 模块 中 : Slim\Http\Cache. 


移 除 Stop/Halt 


Slim Core has removed Stop/Halt. In your applications, you should transition to using the 
withStatus() and withBody() methods. 


重 定向 的 改变 


在 Slim v2.x 我 们 需要 使 用 助手 函数 $app->redirect(); 来 触发 重 定 向 请 求 。 在 Slim v3.x F > 
我 们 可 以 使 用 响应 类 来 做 这 事 。 


Example: 


$app->get('/', function ($req, $res, $args) { 
return $res->withStatus(302)->withHeader('Location', 'your-new-uri'); 


3); 


中 间 件 签名 
中 间 件 的 签名 已 经 从 一 个 类 变 成 了 遂 数 。 


新 的 签名 : 


use Psr\Http\Message\RequestiInterface as Request; 
use Psr\Http\Message\ResponseInterface as Response; 


$app->add(function (Request $req, Response $res, callable $next) { 
// Do stuff before passing along 
$newResponse = $next($req, $res); 
// Do stuff after route is rendered 
return $newResponse; // continue 


3); 


你 仍然 可 以 使 用 类 来 做 签名 : 


namespace My; 


use Psr\Http\Message\RequestInterface as Request; 
use Psr\Http\Message\ResponseInterface as Response; 


class Middleware 


{ 
function __invoke(Request $req, Response $res, callable $next) { 
// Do stuff before passing along 
$newResponse = $next($req, $res); 
// Do stuff after route is rendered 
return $newResponse; // continue 
} 
} 


// Register 

$app->add(new My\Middleware()); 
// or 
$app->add(My\Middleware: :class) ; 


Middleware Execution 


Application middleware is executed as Last In First Executed (LIFE). 


Flash Messages 


Flash messages are no longer a part of the Slim v3 core but instead have been moved to 
seperate Slim Flash package. 


Cookies 


In v3.0 cookies has been removed from core. See FIG Cookies for a PSR-7 compatible 
cookie component. 


Removal of Crypto 


In v3.0 we have removed the dependency for crypto in core. 


New Router 


Slim now utilizes FastRoute, a new, more powerful router! 


This means that the specification of route patterns has changed with named parameters now 
in braces and square brackets used for optional segments: 


// named parameter: 
$app->get('/hello/{name}', /*...*/); 


// optional segment: 
$app->get('/news[/{year}]', /*...*/); 


Route Middleware 


The syntax for adding route middleware has changed slightly. In v3.0: 


$app->get (...)->add($mw2 ) ->add($mw1) ; 


urlFor() is now pathFor() in the router 


urlFor() has been renamed pathFor() and canbe found inthe router object: 


$app->get('/', function ($request, $response, $args) { 
$url = $this->router->pathFor('home'); 
$response->write("<a href='$url'>Home</a>") ; 
return $response; 

})->setName('home'); 


Also, pathFor() is base path aware. 


Container and DI ... Constructing 


Slim uses Pimple as a Dependency Injection Container. 


// index.php 
$app = new Slim\App( 
new \Slim\Container ( 
include '../config/container.config.php' 
) 


Ne 


// Slim will grab the Home class from the container defined below and execute its index m 
// If the class is not defined in the container Slim will still contruct it and pass the 
$app->get('/', Home::class . ':index'); 


// In container .config.php 
// We are using the SlimTwig here 
return [ 
"settings' => [ 
"viewTemplatesDirectory' => '../templates', 
], 
"twig' => [ 
"title' => "', 
"description' => '', 
"author! => '! 
], 
"view' => function ($c) { 
$view = new Twig( 
$c['settings']['viewTemplatesDirectory'], 


[ 
] 


'cache' => false // '../cache' 
); 


// Instantiate and add Slim specific extension 
$view->addExtension( 
new TwigExtension( 
$c['router'], 
$c['request']->getUri() 


Vi 


foreach ($c['twig'] as $name => $value) { 
$view->getEnvironment()->addGlobal($name, $value); 
} 


return $view; 

}, 

Home::class => function ($c) { 
return new Home($c['view']); 





PSR-7 Objects 


Request, Response, Uri & UploadFile are immutable. 


This means that when you change one of these objects, the old instance is not updated. 


// This is WRONG. The change will not pass through. 
$app->add(function (Request $request, Response $response, $next) { 
$request->withAttribute('abc', 'def'); 
return $next($request, $response); 


3); 


// This is correct. 

$app->add(function (Request $request, Response $response, $next) { 
$request = $request->withAttribute('abc', 'def'); 
return $next($request, $response); 


3); 


Message bodies are streams 


UE vere 

$image = _DIR__ . '/huge_photo.jpg'; 

$body = new Stream($image) ; 

$response = (new Response()) 
->withStatus(200, 'OK') 
->withHeader('Content-Type', 'image/jpeg' ) 
->withHeader('Content-Length', filesize($image) ) 
->withBody($body) ; 

HE core 


For text: 


UE oni 
$response = (new Response())->getBody()->write('Hello world!') 


// Or Slim specific: Not PSR-7 compliant. 
$response = (new Response())->write('Hello world!'); 
YUE nei 


Web 服务 器 


典型 地 使 用 前 端 控制 器 将 web 服务 器 接收 到 的 HTTP 请 求 汇集 到 一 个 单独 的 PHP 文件。 下 
面 的 文档 说 明了 如 何 通知 你 的 web 服务 器 将 接收 到 的 HTTP 请 求 发 送 到 PHP 前 端 控制 器 文 
件 。 


PHP built-in server 


Run the following command in terminal to start localhost web server, assuming ./public/ is 
public-accessible directory with index.php file: 


php -S localhost:8080 -t ./public/ 


Apache 配置 


确保 .htaccess 和 index.php 这 两 个 文件 位 于 同一 个 可 公开 访问 的 目录 中 。 这 个 
.htaccess 文件 应 当 和 包含 以 下 代码 : 


RewriteEngine On 

RewriteCond %{REQUEST_FILENAME} !-f 
RewriteCond %{REQUEST_FILENAME} !-d 
RewriteRule “ index.php [QSA,L] 


为 了 保证 htaccess MEH (rewrite) 规则 能 正常 生效 ， 务 必 确 保 你 的 Apache 虚拟 主机 开 
局 了 AllowOverride 选项 > 


AllowOverride All 


Nginx 配置 


这 是 一 个 例子 ， 在 Nginx 虚拟 主机 上 针对 域名 example.com 的 配置 。 它 监听 80 端 口上 的 入 境 
(inbound) HTTP 连接 。 它 假定 一 个 PHP-FPM 服 务 器 在 端口 9000 上 运行 。 你 需要 将 
server_name , error_log , access_log , fo root 这 些 指令 修改 成 你 自己 的 值 。 其 中 root 

指令 是 你 的 应 用 程序 公共 文件 根 目录 的 路 径 ; 你 的 Slim 应 用 的 index.php 前 端 控制 器 文件 

应 该 放 在 这 个 目录 中 。 


server { 
listen 80; 
server_name example.com; 
index index.php; 
error_log /path/to/example.error.1log; 
access_log /path/to/example.access.1log; 
root /path/to/public; 


location / { 
try_files $uri $uri/ /index.php$is_args$args; 
} 


location ~ \.php { 
try_files $uri =404; 
fastcgi_split_path_info %(.+\.php)(/.+)$; 
include fastcgi_params; 
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 
fastcgi_param SCRIPT_NAME $fastcgi_script_name; 
fastcgi_index index.php; 
fastcgi_pass 127.0.0.1:9000; 


HipHop Virtual Machine 


Your HipHop Virtual Machine configuration file should contain this code (along with other 
settings you may need). Be sure you change the sourceRoot setting to point to your Slim 
app’s document root directory. 


Server { 
SourceRoot = /path/to/public/directory 
} 
ServerVariables { 
SCRIPT_NAME = /index.php 
} 
VirtualHost { 
Pattern = .* 
RewriteRules { 
eo 
pattern = A(.*)$ 
to = index.php/$1 
qsa = true 
} 
} 


IIS 


务必 确保 web.config 和 index.php 这 两 个 文件 位 于 同一 个 可 公开 访问 的 目录 中 。 这 个 
Web.config 文件 必须 包含 以 下 代码 : 


<?xml version="1.0" encoding="UTF-8"?> 


<configuration> 
<system.webServer> 
<rewrite> 
<rules> 
<rule name="slim" patternSyntax="Wildcard"> 
<match url="*" /> 
<conditions> 
<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" 
<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="t 
</conditions> 
<action type="Rewrite" url="index.php" /> 
</rule> 
</rules> 
</rewrite> 
</system.webServer> 
</configuration> 


ae me 





lighttpd 


Your lighttpd configuration file should contain this code (along with other settings you may 
need). This code requires lighttpd >= 1.4.24. 


url.rewrite-if-not-file = ("(.*)" => "/index.php/$0" ) 


This assumes that Slim’s index.php is in the root folder of your project (www root). 


教程 


First Application Walkthrough 


- 本 页 延 后 翻译 


如 果 你 在 寻找 创建 一 款 非常 简单 的 Slim 应 用 程序 的 流程 ， 来 这 里 算是 找 对 地 方 了 (在 这 个 应 
用 程序 中 ， 没 有 用 到 Twig， 但 用 到 了 MonoLog 和 一 款 PDO 数据 库 连 接 器 ) 。 你 可 以 在 此 教 
程 中 学 习 如 何 构建 这 个 示例 应 用 程序 ， 也 可 以 按 自己 的 需要 去 改写 某 个 步骤 


在 你 开始 之 前 : 这 里 有 一 个 skeleton 项 目 可 以 帮助 你 快速 创建 一 个 应 用 程序 样板 ， 你 可 以 使 
用 它 直接 开始 创建 你 的 应 用 程序 ， 而 不 用 再 纠结 应 用 程序 的 组 织 结 构 了 。 


此 教程 贯穿 构建 示例 应 用 程序 的 全 流程 。 如 果 有 需求 ， 可 以 在 Github 上 浏览 它 的 项 目 源 
代码 。 


开始 


Start by making a folder for your project (mine is called project , because naming things is 
hard). | like to reserve the top level for things-that-are-not-code and then have a folder for 
source code, and a folder inside that which is my webroot, so my initial structure looks like 
this: 


| 一 project 
L— src 


| 
| L— public 


Installing Slim Framework 


Composer is the best way to install Slim Framework. If you don’t have it already, you can 
follow the installation instructions, in my project I’ve just downloaded the composer.phar into 
my src/ directory and I'll use it locally. So my first command looks like this (I’m in the 

src/ directory): 


php composer.phar require slim/slim 


This does two things: 


e Add the Slim Framework dependency to composer.json (in my case it creates the file 
for me as | don’t already have one, it’s safe to run this if you do already have a 
composer.json file) 


e Run composer install so that those dependencies are actually available to use in your 


application 


If you look inside the project directory now, you'll see that you have a vendor/ folder with all 
the library code in it. There are also two new files: composer.json and composer.lock . This 
would be a great time to get our source control setup correct as well: when working with 
composer, we always exclude the vendor/ directory, but both composer.json and 
composer.lock should be included under source control. Since I’m using composer.phar in 
this directory I’m going to include it in my repo as well; you could equally install the 
composer command on all the systems that need it. 


To set up the git ignore correctly, create a file called src/.gitignore and add the following 
single line to the file: 


vendor /* 


Now git won't prompt you to add the files in vendor/ to the repository - we don’t want to do 
this because we're letting composer manage these dependencies rather than including them 
in our source control repository. 


Create The Application 


There’s a really excellent and minimal example of an index.php for Slim Framework on the 
project homepage so we'll use that as our starting point. Put the following code into 
src/public/index.php 


<?php 
use \Psr\Http\Message\ServerRequestiInterface as Request; 
use \Psr\Http\Message\ResponselInterface as Response; 


require '../vendor/autoload.php'; 


$app = new \Slim\App; 

$app->get('/hello/{name}', function (Request $request, Response $response) { 
$name = $request->getAttribute('name'); 
$response->getBody()->write("Hello, $name"); 


return $response; 


3); 
$app->run(); 


We just pasted a load of code ... let’s take a look at what it does. 


The use statements at the top of the script are just bringing the Request and Response 
classes into our script so we don’t have to refer to them by their long-winded names. Slim 
framework supports PSR-7 which is the PHP standard for HTTP messaging, so you'll notice 
as you build your application that the Request and Response objects are something you 
see often. This is a modern and excellent approach to writing web applications. 


Next we include the vendor/autoload.php file - this is created by Composer and allows us to 

refer to the Slim and other related dependencies we installed earlier. Look out that if you’re 

using the same file structure as me then the vendor/ directory is one level up from your 
index.php and you may need to adjust the path as | did above. 


Finally we create the $app object which is the start of the Slim goodness. The 
$app-&gt;get() Call is our first “route” - when we make a GET request to /hello/someone 
then this is the code that will respond to it. Don’t forget you need that final $app-agt; run() 

line to tell Slim that we’re done configuring and it’s time to get on with the main event. 


Now we have an application, we’ll need to run it. I'll cover two options: the built-in PHP 
webserver, and an Apache virtual host setup. 


Run Your Application With PHP’s Webserver 


This is my preferred “quick start” option because it doesn’t rely on anything else! From the 
src/public directory run the command: 


php -S localhost:8080 


This will make your application available at http://localhost:8080 (if you’re already using port 
8080 on your machine, you'll get a warning. Just pick a different port number, PHP doesn’t 
care what you bind it to). 


Note you'll get an error message about “Page Not Found” at this URL - but it’s an error 
message from Slim, so this is expected. Try http://localhost:8080/hello/joebloggs instead :) 


Run Your Application With Apache 


To get this set up on a standard LAMP stack, we'll need a couple of extra ingredients: some 
virtual host configuration, and one rewrite rule. 


The vhost configuration should be fairly straightforward; we don’t need anything special 
here. Copy your existing default vhost configuration and set the serverName to be how you 
want to refer to your project. For example you can set: 


ServerName slimproject.dev 


Then you'll also want to set the DocumentRoot to point to the public/ directory of your 
project, something like this (edit the existing line): 


DocumentRoot /home/lorna/projects/slim/project/src/public/ 


Don’t forget to restart apache now you've changed the configuration! 


| also havea .htaccess file in my src/public directory; this relies on Apache’s rewrite 
module being enabled and simply makes all web requests go to index.php so that Slim can 
then handle all the routing for us. Here’s my .htaccess file: 


RewriteEngine on 

RewriteCond %{REQUEST_FILENAME} !-d 
RewriteCond %{REQUEST_FILENAME} !-f 
RewriteRule . index.php [L] 


With this setup, just remember to use hittp://slimproject.dev instead of http://localhost:8080 in 
the other examples in this tutorial. The same health warning as above applies: you'll see an 
error page at http://slimproject.dev but crucially it’s Slim’s error page. If you go to 
http://slimproject.dev/hello/joebloggs then something better should happen. 


Configuration and Autoloaders 


Now we've set up the platform, we can start getting everything we need in place in the 
application itself. 


Add Config Settings to Your Application 


The initial example uses all the Slim defaults, but we can easily add configuration to our 
application when we create it. There are a few options but here I’ve just created an array of 
config options and then told Slim to take its settings from here when | create it. 


First the configuration itself: 


$config['displayErrorDetails'] = true; 


$config['db']['host'] = "localhost"; 
$config['db']['user'] = "user"; 
$config['db']['pass'] = "password"; 
$config['db']['dbname'] = "exampleapp"; 


The first line is the most important! Turn this on in development mode to get information 
about errors (without it, Slim will at least log errors so if you’re using the built in PHP 
webserver then you'll see them in the console output which is helpful). The other settings 
here are not specific keys/values, they're just some data that | want to be able to access 
later. 


Now to feed this into Slim, we need to change where we create the slim/App object so that 
it now looks like this: 


$app = new \Slim\App(["settings" => $config]); 


We'll be able to access any settings we put into that $config array from our application 
later on. 


Set up Autoloading for Your Own Classes 


We already added the composer autoloader file, but what about the code that we write that 
isn’t part of the composer libraries? One option is to use Composer to manage autoloading 
rules which is a great solution, but you can also add your own autoloader if you want to. 


My setup is pretty simple since | only have a few extra classes, they’re just in the global 
namespace, and the files are in the src/classes/ directory. So to add the autoloader, | have 
this block of code after the vendor/autoload.php file is required: 


spl_autoload_register(function ($classname) { 
require ("../classes/" . $classname . ".php"); 


3); 


The spl autoload register function accepts the (namespaced) class name and then by the 
end of the function, the class code should have been included. 


Add Dependencies 


Most applications will have some dependencies, and Slim handles them nicely using a DIC 
(Dependency Injection Container) built on Pimple. This example will use both Monolog and a 
PDO connection to MySQL. 


The idea of the dependency injection container is that you configure the container to be able 
to load the dependencies that your application needs, when it needs them. Once the DIC 
has created/assembled the dependencies, it stores them and can supply them again later if 
needed. 


To get the container, we can add the following after the line where we create sapp and 
before we start to register the routes in our application: 


$container = $app->getContainer(); 
Now we have the slim\container object, we can add our services to it. 


Use Monolog In Your Application 


If you’re not already familiar with Monolog, it’s an excellent logging framework for PHP 
applications, which is why I’m going to use it here. First of all, get the Monlog library installed 
via Composer: 


php composer.phar require monolog/monolog 


The dependency is named logger and the code to add it looks like this: 


$container['logger'] = function($c) { 
$logger = new \Monolog\Logger('my_logger'); 
$file_handler = new \Monolog\Handler\StreamHandler("../logs/app.log"); 
$logger ->pushHandler ($file_handler ); 
return $logger; 


}; 


We're adding an element to the container, which is itself an anonymous function (the $c 
that is passed in is the container itself so you can acess other dependencies if you need to). 
This will be called when we try to access this dependency for the first time; the code here 
does the setup of the dependency. Next time we try to access the same dependence, the 
same object that was created the first time will be used the next time. 


My Monolog config here is fairly light; just setting up the application to log all errors to a file 
called 1logs/app.log (remember this path is from the point of view of where the script is 
running, i.e. index.php ). 


With the logger in place, | can use it from inside my route code with a line like this: 


$this->Logger ->addInfo("Something interesting happened"); 


Having good application logging is a really important foundation for any application so I'd 
always recommend putting something like this in place. This allows you to add as much or 
as little debugging as you want, and by using the appropriate log levels with each message, 
you can have as much or as little detail as is appropriate for what you’re doing in any one 
moment. 


Add A Database Connection 


There are many database libraries available for PHP, but this example uses PDO - this is 
available in PHP as standard so it’s probably useful in every project, or you can use your 
own libraries by adapting the examples below. 


Exactly as we did for adding Monolog to the DIC, we'll add an anonymous function that sets 
up the dependency, in this case called db : 


$container['db'] = function ($c) { 
$db = $c['settings']['db']; 
$pdo = new PDO("mysql:host="_. $db['host'] . ";dbname="_. $db['dbname'], 
$db['user'], $db['pass']); 
$pdo->setAttribute(PDO: :ATTR_ERRMODE, PDO: :ERRMODE_EXCEPTION); 
$pdo->setAttribute(PDO: :ATTR_DEFAULT_FETCH_MODE, PDO: :FETCH_ASSOC); 
return $pdo; 


}; 


Remember the config that we added into our app earlier? Well, this is where we use it - the 
container knows how to access our settings, and so we can grab our configuration very 
easily from here. With the config, we create the Poo object (remember this will throw a 

PDOException if it fails and you might like to handle that here) so that we can connect to the 
database. lve included two setattribute() calls that really aren’t necessary but | find these 
two settings make PDO itself much more usable as a library so | left the settings in this 
example so you can use them too! Finally, we return our connection object. 


Again, we can access our dependencies with just $this-agt; and then the name of the 
dependency we want which in this case is $this-&gt;db , so there is code in my application 
that looks something like: 


$mapper = new TicketMapper($this->db) ; 


This will fetch the db dependency from the DIC, creating it if necessary, and in this 
example just allows me to pass the ppo object straight into my mapper class. 


Create Routes 


“Routes” are the URL patterns that we'll describe and attach functionality to. Slim doesn’t 
use any automatic mapping or URL formulae so you can make any route pattern you like 
map onto any function you like, it’s very flexible. Routes can be linked to a particular HTTP 
verb (such as GET or POST), or more than one verb. 


As a first example, here’s the code for making a GET request to /tickets which lists the 
tickets in my bug tracker example application. It just spits out the variables since we haven't 
added any views to our application yet: 


$app->get('/tickets', function (Request $request, Response $response) { 
$this->logger ->addInfo("Ticket list"); 
$mapper = new TicketMapper($this->db); 
$tickets = $mapper->getTickets(); 


$response->getBody()->write(var_export($tickets, true)); 
return $response; 


3); 


The use of $app-&gt;get() here means that this route is only available for GET requests; 

there’s an equivalent $app-&gt;post() call that also takes the route pattern and a callback 
for POST requests. There are also methods for other verbs - and also the map() function 

for situations where more than one verb should use the same code for a particular route. 


Slim routes match in the order they are declared, so if you have a route which could overlap 
another route, you need to put the most specific one first. Slim will throw an exception if 
there’s a problem, for example in this application | have both /ticket/new and 

/ticket/{id} and they need to be declared in that order otherwise the routing will think that 
“new” is an ID! 


In this example application, all the routes are in index.php but in practice this can make for 
a rather long and unwieldy file! It’s fine to refactor your application to put routes into a 
different file or files, or just register a set of routes with callbacks that are actually declared 
elsewhere. 


All route callbacks accept three parameters (the third one is optional): 


e Request: this contains all the information about the incoming request, headers, 
variables, etc. 

e Response: we can add output and headers to this and, once complete, it will be turned 
into the HTTP response that the client receives 

e Arguments: the named placeholders from the URL (more on those in just a moment), 
this is optional and is usually omitted if there aren’t any 


This emphasis on Request and Response illustrates Slim 3 being based on the PSR-7 
standard for HTTP Messaging. Using the Request and Response object also makes the 
application more testable as we don’t need to make actual requests and responses, we can 
just set up the objects as desired. 


Routes with Named Placeholders 


Sometimes, our URLs have variables in them that we want to use in our application. In my 
bug tracking example, | want to have URLs like /ticket/42 to refer to the ticket - and Slim 
has an easy way of parsing out the “42” bit and making it available for easy use in the code. 
Here’s the route that does exactly that: 


$app->get('/ticket/{id}', function (Request $request, Response $response, $args) { 
$ticket_id = (int)$args['id']; 
$mapper = new TicketMapper($this->db); 
$ticket = $mapper->getTicketById($ticket_id); 


$response->getBody()->write(var_export($ticket, true)); 
return $response; 


}); 


Look at where the route itself is defined: we write it as /ticket/{id} . When we do this, the 
route will take the portion of the URL from where the {id} is declared, and it becomes 
available as $args['id'] inside the callback. 


Using GET Parameters 


Since GET and POST send data in such different ways, then the way that we get that data 
from the Request object differs hugely in Slim. 


It is possible to get all the query parameters from a request by doing 
$request -&gt;getQueryParams() Which will return an associative array. So for the URL 
/tickets?sort=date&order=desc We'd get an associative array like: 


["sort" => "date", "order" => "desc"] 


These can then be used (after validating of course) inside your callback. 


Working with POST Data 


When working with incoming data, we can find this in the body. Weve already seen how we 
can parse data from the URL and how to obtain the GET variables by doing 

$request -&gt;getQueryParams() but what about POST data? The POST request data can be 
found in the body of the request, and Slim has some good built in helpers to make it easier 
to get the information in a useful format. 


For data that comes from a web form, Slim will turn that into an array. My tickets example 
application has a form for creating new tickets that just sends two fields: “title” and 
“description”. Here is the first part of the route that receives that data, note that fora POST 
route use $app-&gt;post() rather than $app-agt;get() : 


$app->post('/ticket/new', function (Request $request, Response $response) { 
$data = $request->getParsedBody( ); 
$ticket_data = []; 
$ticket_data['title'] = filter_var($data['title'], FILTER_SANITIZE_STRING); 
$ticket_data['description'] = filter_var($data['description'], FILTER_SANITIZE_STRING 
We na 
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The call to $request-&gt;getParsedBody() asks Slim to look at the request and the 
Content-Type headers of that request, then do something smart and useful with the body. In 

this example it’s just a form post and so the resulting $data array looks very similar to what 

we'd expect from s$ post - and we can go ahead and use the filter extension to check the 


value is aceptable before we use it. Ahuge advantage of using the built in Slim methods is 
that we can test things by injecting different request objects - if we were to use $_POST 
directly, we aren't able to do that. 


What's really neat here is that if you’re building an API or writing AJAX endpoints, for 

example, it’s super easy to work with data formats that arrive by POST but which aren't a 

web form. As long as the Content-Type header is set correctly, Slim will parse a JSON 

payload into an array and you can access it exactly the same way: by using 
$request -&gt; getParsedBody( ) 


Views and Templates 


Slim doesn’t have an opinion on the views that you should use, although there are some 
options that are ready to plug in. Your best choices are either Twig or plain old PHP. Both 
options have pros and cons: if you’re already familiar with Twig then it offers lots of excellent 
features and functionality such as layouts - but if you’re not already using Twig, it can be a 
large learning curve overhead to add to a microframework project. If you’re looking for 
something dirt simple then the PHP views might be for you! | picked PHP for this example 
project, but if you’re familiar with Twig then feel free to use that; the basics are mostly the 
same. 


Since we'll be using the PHP views, we'll need to add this dependency to our project via 
Composer. The command looks like this (similar to the ones you've already seen): 


php composer.phar require slim/php-view 


In order to be able to render the view, we'll first need to create a view and make it available 
to our application; we do that by adding it to the DIC. The code we need goes with the other 
DIC additions near the top of src/public/index.php and it looks like this: 


$container['view'] = new \Slim\Views\PhpRenderer("../templates/"); 


Now we have a view element in the DIC, and by default it will look for its templates in the 
src/templates/ directory. We can use it to render templates in our actions - here’s the ticket 
list route again, this time including the call to pass data into the template and render it: 


$app->get('/tickets', function (Request $request, Response $response) { 
$this->logger ->addInfo("Ticket list"); 
$mapper = new TicketMapper($this->db); 
$tickets = $mapper->getTickets(); 


$response = $this->view->render($response, "tickets.phtml", ["tickets" => $tickets]); 
return $response; 


}); 
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The only new part here is the penultimate line where we set the $response variable. Now 
that the view isin the DIC, we can refer to it as $this-agt;view . Calling render() needs 
us to supply three arguments: the $response to use, the template file (inside the default 
templates directory), and any data we want to pass in. Response objects are immutable 
which means that the call to render() wont update the response object; instead it will 
return us a new object which is why it needs to be captured like this. This is always true 
when you operate on the response object. 


When passing the data to templates, you can add as many elements to the array as you 
want to make available in the template. The keys of the array are the variables that the data 
will exist in once we get to the template itself. 


As an example, here’s a snippet from the template that displays the ticket list (i.e. the code 
from src/templates/tickets.phtml - which uses Pure.css to help cover my lack of frontend 
skills): 


<hi>All Tickets</h1> 
<p><a href="/ticket/new">Add new ticket</a></p> 


<table class="pure-table"> 
<tr> 
<th>Title</th> 
<th>Component</th> 
<th>Description</th> 
<th>Actions</th> 
</tr> 


<?php foreach($data['tickets'] as $ticket): ?> 


<tr> 
<td><?=$ticket->getTitle() ?></td> 
<td><?=$ticket->getComponent() ?></td> 
<td><?=$ticket->getShortDescription() ?> ...</td> 
<td> 
<a href="<?=$router->pathFor('ticket-detail', ['id' => $ticket->getId()])?>"> 
</td> 
</tr> 


<?php endforeach; ?> 
</table> 
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In this case, $tickets is actually a TicketEntity class with getters and setters, but if you 
passed in an array, you’d be able to access it using array rather than object notation here. 


Did you notice something fun going on with $router-&gt;pathFor() right at the end of the 
example? Lets talk about named routes next :) 


Easy URL Building with Named Routes 


When we create a route, we can give ita name by calling -&gt;setName() on the route 
object. In this case, | am adding the name to the route that lets me view an individual ticket 
so that | can quickly create the right URL for a ticket by just giving the name of the route, so 
my code now looks something like this (just the changed bits shown here): 


$app->get('/ticket/{id}', function (Request $request, Response $response, $args) { 
// 


})->setName("ticket-detail"); 


To use this in my template, | need to make the router available in the template that’s going to 
want to create this URL, so I’ve amended the tickets/ route to pass a router through to the 
template by changing the render line to look like this: 


$response = $this->view->render($response, "tickets.phtml", ["tickets" => $tickets, "rou 
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With the /tickets/{id} route having a friendly name, and the router now available in our 
template, this is is what makes the pathFor() call in our template work. By supplying the 

id , this gets used as a named placeholder in the URL pattern, and the correct URL for 
linking to that route with those values is created. This feature is brilliant for readable 
template URLs and is even better if you ever need to change a URL format for any reason - 
no need to grep templates to see where it’s used. This approach is definitely recomended, 
especially for links you'll use a lot. 


Where Next? 


This article gave a walkthrough of how to get set up with a simple application of your own, 
which | hope will let you get quickly started, see some working examples, and build 
something awesome. 


From here, I’d recommend you take a look at the other parts of the project documentation for 
anything you need that wasn’t already covered or that you want to see an alternative 
example of. A great next step would be to take a look at the Middleware section - this 
technique is how we layer up our application and add functionality such as authentication 
which can be applied to multiple routes. 


概念 


PSR 7 与 值 对 象 (Value Objects ) 


Slim 为 其 请 求 和 响应 对 象 支持 了 PSR-7 接口 。 这 使 得 Slim 更 加 灵活 了 ， 因 为 它 可 以 使 用 任 
意 PSR-7 实现 方法 。 例 如 ， 一 个 Slim 应 用 程序 不 必 返 回 一 个 \slim\Http\Response 的 实 

例 。 它 可 以 这 样子 ， 举 例 来 说 ， 比 如 返回 一 个 \GuzzleHttp\Psr7\Cachingstream 的 实例 ， 或 
Æ > È \GuzzleHttp\Psr7\stream_for() 函数 返回 的 任意 实例 。 


Slim 提供 了 它 自 有 的 PSR-7 实现 方法 ， 使 其 可 以 开 箱 即 用 。 然 而 ， 你 可 以 自由 地 用 第 三 方 实 
现 方法 来 替换 Slim 的 默认 PSR 7 对 象 。 只 需 复写 应 用 容器 的 request 和 response 服务 ， 
这 样 它们 就 能 分 别 返 回 一 个 \Psr\Http\Message\ServerRequestinterface 和 


\Psr\Http\Message\ResponselInterface 的 实例 。 


值 对 象 (Value objects ) 


Se ee A ee ee 
改变 它们 。 值 对 象 有 一 个 额定 的 开销 ， 因 为 它们 必须 在 更 新 时 进行 克隆 。 这 个 开销 并 不 会 以 
任何 有 实际 意义 的 方式 影响 到 性 能 。 


你 可 以 通过 调用 任意 PSR 7 接口 方法 来 请 求 值 对 象 的 拷贝 【这 些 方 法 通常 带 有 with 前 
级 ) 。 例 如 ， 一 个 PSR 7 响应 对 象 有 一 个 withHeader($name, $value) 方法 ， 它 返回 一 个 克 
隆 的 带 有 新 HTTP 头 的 值 对 象 。 


<?php 
$app = new \Slim\App; 
$app->get('/foo', function ($req, $res, $args) { 
return $res->withHeader ( 
"Content-Type', 
"application/json' 
3); 
$app->run(); 


PSR 7 接口 提供 了 以 下 方法 来 转换 请 求 和 响应 对 象 : 


@ withProtocolVersion($version) 
@ withHeader($name, $value) 

@ withAddedHeader($name, $value) 
@ withoutHeader ($name) 


© withBody(StreamInterface $body) 
PSR 7 接口 提供 了 以 下 方法 来 转换 请 求 对 象 : 


© withMethod($method) 


© withUri(UriInterface $uri, $preserveHost = false) 


© withCookieParams(array $cookies) 

@ withQueryParams(array $query) 

e withUploadedFiles(array $uploadedFiles) 
èe withParsedBody($data) 

e withAttribute($name, $value) 


@ withoutAttribute($name) 
PSR 7 接口 提供 了 以 下 方法 来 转换 响应 对 象 : 
@ withStatus($code, $reasonPhrase = '') 


访问 PSR-7 文档 了 解 关 于 这 些 方法 的 更 多 信息 吧 。 


中 间 件 


你 可 以 在 你 的 Slim 应 用 之 前 (before) 和 之 后 (after) 运行 代码 来 处 理 你 认为 合适 的 请 求 
和 响应 对 象 。 这 就 叫做 中 间 件 。 为 什么 要 这 么 做 呢 ? 比如 你 想 保 护 你 的 应 用 不 遭受 跨 站 请 求 
伪造 。 也 许 你 想 在 应 用 程序 运行 前 验证 请 求 。 中 间 件 对 这 些 场景 的 处 理 简直 完美 。 


什么 是 中 间 件 ? 
从 技术 上 来 讲 ， 中 间 件 是 一 个 接收 三 个 参数 的 可 回调 (callable) 对 象 : 


1. \Psr\Http\Message\ServerRequestiInterface - PSR7 请 求 对 象 
2. \PsrNHttp\Message\ResponseInterface - PSR7 响应 对 象 
3. callable -下 一 层 中 间 件 的 回调 对 象 


它 可 以 做 任何 与 这 些 对 象 相应 的 事情 。 唯 一 硬性 要 求 就 是 中 间 件 必须 返回 一 个 
\Psr\Http\Message\ResponseInterface 的 实例 。 每 个 中 间 件 都 应 当 调用 下 一 层 中 间 件 ， 并 讲 
请 求 和 响应 对 象 作为 参数 传递 给 它 〈 下 一 层 中 间 件 ) 。 


中 间 件 是 如 何 工 作 的 ? 


不 同 的 框架 使 用 中 间 件 的 方式 不 同 。 在 Slim 框架 中 ， 中 间 件 层 以 同心 圆 的 方式 包 计 着 核心 应 
用 。 由 于 新 增 的 中 间 件 层 总 会 包 庄 所 有 已 经 存在 的 中 间 件 层 。 当 添加 更 多 的 中 间 件 层 时 同心 
圆 结构 会 不 断 的 向 外 扩展 。 


4 Slim 应 用 运行 时 ， 请 求 对 象 和 响应 对 象 从 外 到 内 穿 过 中 间 件 结构 。 它 们 首先 进入 最 外 层 的 
中 间 件 ， 然 后 然后 进入 下 一 层 ， (以 此 类 推 ) 。 直 到 最 后 它们 到 达 了 Slim 应 用 程序 自身 。 在 
Slim 应 用 分 派 了 对 应 的 路 由 后 ， 作 为 结果 的 响应 对 象 离开 Slim 应 用 ， 然 后 从 内 到 外 穿 过 中 间 
件 结构 。 最 终 ， 最 后 出 来 的 响应 对 象 离开 了 最 外 层 的 中 间 件 ， 被 序列 化 为 一 个 原始 的 HTTP 
响应 消息 ， 并 返回 给 HTTP 客户 端 。 下 图 清楚 的 说 明了 中 间 件 的 工作 流程 : 
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如 何 编写 中 间 件 ? 


中 间 件 是 一 个 接收 三 个 参数 的 可 回调 (callable) 对 象 ， 三 个 参数 是 : 请 求 对 象 、 响 应 对 象 以 
及 下 一 层 中 间 件 。 中 间 件 必须 返回 一 个 \psr\Http\Message\ResponseInterface 的 实例 。 


闭 包 中 间 件 示例 。 


这 个 示例 中 间 件 是 一 个 闭 包 。 


中 间 件 , 


<?php 
[ax 
* Example middleware closure 


* 

* @param \Psr\Http\Message\ServerRequestInterface $request PSR7 request 

* @param \Psr\Http\Message\ResponseInterface $response PSR7 response 

* @param callable $next Next middleware 
* 

* 


@return \Psr\Http\Message\ResponseInterface 
27 

function ($request, $response, $next) { 

$response->getBody()->write('BEFORE'); 

$response = $next($request, $response); 

$response->getBody()->write('AFTER'); 


return $response; 


}; 


可 调用 类 的 中 间 件 示例 。 
这 个 示例 中 间 件 是 一 个 实现 了 _invoke() 魔术 方法 的 可 调用 类 。 


<?php 
class ExampleMiddleware 


{ 
Ups 
Example middleware invokable class 


* 
* 
* @param \Psr\Http\Message\ServerRequestInterface $request PSR7 request 
* @param \Psr\Http\Message\ResponseInterface $response PSR7 response 
* @param callable $next Next middleware 
* 
* @return \Psr\Http\Message\ResponseInterface 
public function __invoke($request, $response, $next) 
{ 
$response->getBody()->write('BEFORE'); 
$response = $next($request, $response); 
$response->getBody()->write('AFTER'); 


return $response; 


要 使 用 这 个 类 作为 中 间 件 ， 你 可 以 使 用 -&gt;add( new ExampleMiddleware() ); 函数 连接 在 
$app ，Route ,或 group() 之 后 ， 在 下 面 的 代码 中 ， 它 们 中 的 任意 一 个 都 可 以 表示 
$subject ° 


$subject->add( new ExampleMiddleware() ); 


如 何 添加 中 间 件 ? 


你 可 以 在 Slim 应 用 中 添加 中 间 件 ， 或 者 添加 到 一 个 单独 的 Slim 应 用 路 由 ， 或 者 是 路 由 组 。 
所 有 场景 都 能 接受 相同 的 中 间 件 和 实现 相同 的 中 间 件 接口 。 


应 用 程序 中 间 件 


应 用 程序 中 间 件 被 每 个 传 入 (incoming) HTTP 请 求 调 用 。 应 用 中 间 件 可 以 通过 Slim 应 用 实 
例 的 add() 方法 来 添加 。 下 面 这 是 一 个 添加 上 面 那 个 闭 包 中 间 件 的 例子 : 


<?php 
$app = new \Slim\App(); 


$app->add(function ($request, $response, $next) { 
$response->getBody()->write('BEFORE'); 
$response = $next($request, $response); 
$response->getBody()->write('AFTER'); 


return $response; 

3); 

$app->get('/', function ($req, $res, $args) { 
echo ' Hello '; 


3); 
$app->run(); 


输出 的 HTTP 响应 主体 为 : 


BEFORE Hello AFTER 


路 由 中 间 件 


路 由 中 间 件 只 有 在 当前 HTTP 请 求 的 方法 和 URI 都 与 中 间 件 所 在 路 由 相 匹 配 时 才 会 被 调用 。 

路 由 中 间 件 会 在 你 调用 了 任意 Slim 应 用 的 路 由 方法 (e.g.，get() 或 post ) 后 被 立即 指 

定 。 每 个 路 由 方法 返回 一 个 \slim\Route 的 实例 ， 这 个 类 提供 了 相同 的 中 间 件 接口 作为 Slim 
应 用 的 实例 。 使 用 路 由 实例 的 ado 方法 将 中 间 件 添加 到 路 由 中 。 下 面 这 是 一 个 添加 上 面 那 
个 闭 包 中 间 件 的 例子 : 


<?php 
$app = new \Slim\App(); 


$mw = function ($request, $response, $next) { 
$response->getBody( )->write('BEFORE'); 
$response = $next($request, $response); 
$response->getBody()->write('AFTER'); 


return $response; 

}; 

$app->get('/', function ($req, $res, $args) { 
echo ' Hello '; 

})->add($mw) ; 


$app->run(); 


输出 的 HTTP 响应 主体 为 : 


BEFORE Hello AFTER 


Group Middleware 


除了 整个 应 用 ， 以 及 标准 的 路 由 可 用 接收 中 间 件 ， 还 有 group 多 路 由 定义 功能 同样 允许 在 
其 内 部 存在 独立 的 路 由 。 路 由 组 中 间 件 只 有 在 其 路 由 与 已 定义 的 HTTP 请 求 和 URI 中 的 一 个 
相 匹配 时 才 会 被 调用 。 要 在 回调 中 添加 中 间 件 ， 以 及 整 组 中 间 件 ， 通 过 在 group() 方法 后 面 
连接 add() 来 设置 。 


下 面 的 示例 程序 ， 在 一 组 URL 处 理 程序 (url-handlers) 中 使 用 了 回调 中 间 件 。 


<?php 

require_once __DIR__.'/vendor/autoload.php'; 
$app = new \Slim\App(); 

$app->get('/', function ($request, $response) { 


return $response->getBody()->write('Hello World'); 
}); 


$app->group('/utils', function () use ($app) { 
$app->get('/date', function ($request, $response) { 
return $response->getBody()->write(date('Y-m-d H:i:s')); 


$app->get('/time', function ($request, $response) { 
return $response->getBody()->write(time()); 


})->add(function ($request, $response, $next) { 
$response->getBody()->write('It is now '); 
$response = $next($request, $response); 
$response->getBody()->write('. Enjoy!'); 


return $response; 


3); 
在 调用 yutils/date 方法 时 ， 将 输出 类 似 下 面 这 样子 的 字符 串 : 


It is now 2015-07-06 03:11:01\. Enjoy! 


访问 /utils/time 将 会 输出 类 似 下 面 这 样子 的 字符 串 : 


It is now 1436148762\. Enjoy! 


但 访问 / 域名 根 目录 (aomain-root 时 ， 将 会 有 如 下 输出 ， 因 为 并 没有 分 配 中 间 件 。 


Hello world 


依赖 容器 (Dependency Container ) 


Slim 使 用 依赖 容器 来 准备 、 管 理 和 注入 应 用 程序 的 相关 依赖 。Slim 支持 Container-Interop 4# 
口 实现 的 容器 。 你 可 以 使 用 Slim 的 内 置 容器 (基于 Pimple) 或 者 第 三 方 的 容器 ， 比 如 
Acclimate 或 PHP-DI ° 


如 何 使 用 容器 


你 并 不 必须 提供 一 个 依赖 容器 。 如 果 你 提供 了 ， 那 么 ， 你 必须 注入 此 容器 的 实例 到 Slim 应 用 
程序 的 构造 函数 中 。 


$container = new \Slim\Container; 
$app = new \Slim\App($container ) ; 


你 可 以 显 式 或 隐 式 地 从 依赖 容器 中 获取 服务 。 你 可 以 像 下 面 这 样子 从 Slim 应 用 程序 的 路 由 中 
获取 一 个 显示 的 容器 实例 。 


/"* 
* Example GET route 
* 
* @param \Psr\Http\Message\ServerRequestInterface $req PSR7 request 
* @param \Psr\Http\Message\ResponseInterface $res PSR7 response 
* @param array $args Route parameters 
* 
* 


@return \Psr\Http\Message\ResponseInterface 
2 

$app->get('/foo', function ($req, $res, $args) { 
$myService = $this->get('myService'); 


return $res; 


3); 


你 可 以 这 样 隐 式 地 从 容器 中 取得 服务 : 


/"* 
* Example GET route 
* 
* @param \Psr\Http\Message\ServerRequestInterface $req PSR7 request 
* @param \Psr\Http\Message\ResponseInterface $res PSR7 response 
* @param array $args Route parameters 
* 
* 


@return \Psr\Http\Message\ResponselInterface 
oi 

$app->get('/foo', function ($req, $res, $args) { 
$myService = $this->myService; 


return $res; 


3); 


Slim uses _get() and _ isset() magic methods that defer to the application’s container 
for all properties that do not already exist on the application instance. 


必需 的 服务 

你 的 容器 必须 实现 这 些 必 需 的 服务 。 如 果 你 使 用 的 是 Slim 内 置 的 容器 ， 这 些 服务 都 是 已 经 准 
备 好 了 的 。 如 果 你 选择 使 用 第 三 方 容器 ， 那 么 你 必须 自己 来 实现 这 些 服务 。 

settings 

应 用 程序 设置 项 的 关联 数组 (Associative array) ， 包 括 以 下 关键 字 : 


© httpVersion 

@ responseChunkSize 

e outputBuffering 

© determineRouteBeforeAppMiddleware . 


e displayErrorDetails . 
environment 
\Slim\Interfaces\Http\EnvironmentiInterface 的 实例 . 
request 

\Psr\Http\Message\ServerRequestiInterface 的 实例 . 
response 

\Psr\Http\Message\ResponselInter face 的 实例 . 
router 

\Slim\Interfaces\RouterInterface 的 实例 . 
foundHandler 
\Slim\Interfaces\InvocationStrategyInterface 的 实例 . 
phpErrorHandler 


PHP 7 错误 被 抛 出 时 调用 的 Callable。 这 个 callable 必须 返回 一 个 
\Psr\Http\Message\ResponseInterface 的 实例 ， 并 接收 三 个 参数 : 


1. \Psr\Http\Message\ServerRequestInter face 
2. \Psr\Http\Message\ResponselInterface 


3. \Error 


errorHandler 


抛 出 异常 时 调用 的 Callable。 这 个 callable 必须 返回 一 个 
\Psr\Http\Message\ResponseInterface 的 实例 ， 并 接收 三 个 参数 : 


1. \Psr\Http\Message\ServerRequestInter face 
2. \Psr\Http\Message\ResponseInterface 


3. \Exception 
notFoundHandler 


如 果 当 前 的 HTTP 请 求 URI 未 能 匹配 到 应 用 程序 路 由 ， 则 调用 这 个 Callable。 这 个 callable 
必须 返回 一 个 \psr\Http\Message\ResponseInterface 的 实例 ， 并 接收 三 个 参数 : 


1. \Psr\Http\Message\ServerRequestInter face 


2. \Psr\Http\Message\ResponseInterface 
notAllowedHandler 


如 果 一 个 应 用 程序 路 由 匹配 到 当前 HTTP 请 求 的 路 径 而 不 是 它 的 方法 ， 则 调用 这 个 
Callable。 这 个 callable 必须 返回 一 个 \Psr\Http\Message\ResponseInterface 的 实例 并 接收 
三 个 参数 : 


1. \Psr\Http\Message\ServerRequestInterface 


2. \Psr\Http\Message\ResponseInterface 
3. Array of allowed HTTP methods 


callableResolver 


\Slim\Interfaces\CallableResolverInterface 的 实 例 i 


Application 


Application > (或 者 slim\app ) 是 你 的 Slim 应 用 程序 的 入 口 ， 它 被 用 于 注册 那些 链接 到 
回调 和 控制 器 的 路 由 。 


// 实例 化 App +H 

$app = new \Slim\App(); 

// 添加 路 由 回调 

$app->get('/', function ($request, $response, $args) { 
return $response->withStatus(200)->write('Hello World!'); 


3); 


// 运行 应 用 
$app->run(); 


Application 配置 


Application 只 接收 一 个 参数 。 该 参数 可 以 是 容器 实例 或 者 用 于 配置 自动 创建 的 默认 容器 的 数 
组 。 


Slim 还 用 到 了 一 系列 的 设置 项 。 它 们 被 存放 在 settings 配置 关键 字 中 。 你 还 可 以 添加 你 的 
应 用 程序 私有 的 设置 项 。 


例如 ， 我 们 可 以 将 Slim 的 设置 项 displayErrorDetails 设置 为 true， 并 配置 Monolog， 像 这 
样 : 
$config = [ 
"settings' => [ 
"displayErrorDetails' => true, 
"logger' => [ 
'name' => 'slim-app', 
'level' => Monolog\Logger: :DEBUG, 


"path' => _DIR . '/../logs/app.log', 
], 


1, 
]; 
$app = new \Slim\App($config); 


获取 Settings 


由 于 设置 项 都 被 存放 在 依赖 注入 容器 中 ， 所 以 你 可 以 通过 容器 工厂 方法 (container 
factories) 的 settings 关键 字 来 访问 它们 。 例 如 : 


$settings = $container->get('settings')['logger']; 


还 可 以 在 路 由 回调 (route callable) 中 通过 sthis 来 访问 它们 : 


$app->get('/', function ($request, $response, $args) { 
$loggerSettings = $this->get('settings')['logger']; 
Wl a0 

3); 


Slim 的 默认 设置 


Slim 拥有 以 下 默认 设置 ， 你 可 以 按 需 覆 写 它们 : 

httpVersion 

HTTP 响应 对 象 使 用 的 HTTP 协议 版 本 (RU: '1.1' ) 

responseChunkSize 

从 响应 体 读 取 并 发 送 到 浏览 器 的 数据 包 的 大 小 。 (默认 : 4096 ) 

outputBuffering 

当 设 置 为 false 时 ， 那 么 没有 输出 缓冲 被 启用 。 如 果 'append' 或 'prepend! ， 那 么 任意 


echo 或 print 状态 都 会 被 捕获 ， 并 且 会 appended 或 prepended 到 从 路 由 回调 (route 
callable) 中 返回 的 响应 中 。 (RU: 'append' ) 


determineRouteBeforeAppMiddleware 


当 设 置 为 true 时 ， 那 么 在 中 间 件 执行 前 即 已 确定 路 由 是 否 正 确 。 这 意味 着 你 如 果 有 需要 ， 可 
以 在 中 间 件 中 检查 路 由 参数 。 (RU: false ) 


displayErrorDetails 


当 设 置 为 true 时 , 关于 异常 的 附加 信息 都 会 通过 默认 的 错误 处 理 器 显示 出 来 。( 上 默认: false ) 


HTTP 请 求 


Slim 应 用 程序 的 路 由 和 中 间 件 给 出 了 一 个 PSR 7 请 求 对 象 ， 它 表示 当前 的 HTTP 请 求 是 由 
Web 服务 器 接收 到 的 。 该 请 求 对 象 遵 循 PSR 7 服务 器 请 求 接 口 (ServerRedquestlnterface ) 
实现 ， 因 此 你 可 以 检查 和 操作 该 HTTP 请 求 对 象 的 方法 、 头 和 体 。 


如 何 获 取 请 求 对 象 


该 PSR 7 请 求 对 象 作 为 路 由 回调 的 第 一 个 参数 注入 到 你 的 Slim 应 用 程序 的 路 由 中 ， 像 这 
样 : 


<?php 
use Psr\Http\Message\ServerRequestinter face; 
use Psr\Http\Message\ResponselInter face; 


$app = new \Slim\App; 

$app->get('/foo', function (ServerRequestInterface $request, ResponseInterface $response) 
// 使 用 PSR 7 $request 对 象 
return $response; 


}); 
$app->run(); 


EE 


Figure 1: 将 PSR 7 请 求 注入 到 应 用 程序 的 路 由 回调 中 。 





该 PSR 7 请 求 对 象 作 为 中 间 件 callable 的 第 一 个 参数 注入 到 Slim 应 用 程序 的 中 间 件 中 ， 像 这 
RE: 


<?php 
use Psr\Http\Message\ServerRequestinter face; 
use Psr\Http\Message\ResponselInter face; 


$app = new \Slim\App; 
$app->add(function (ServerRequestInterface $request, ResponseInterface $response, callabl 
// Use the PSR 7 $request object 


return $next($request, $response); 


3); 


// Define app routes... 
$app->run(); 


E 一 


Figure 2: 注入 PSR 7 请 求 到 应 用 程序 中 间 件 





请 求 的 方法 


每 个 HTTP 请 求 都 有 相应 的 方法 ， 通 常 是 这 些 中 的 一 个 : 


e GET 

e POST 

e PUT 

e DELETE 
e HEAD 

e PATCH 

e OPTIONS 


你 可 以 恰当 地 使 用 getmethod() 请 求 对 象 方法 来 检查 HTTP 请 求 方法 。 


$method = $request->getMethod(); 


由 于 这 是 一 个 常见 的 功能 ，Slim 的 内 置 PSR7 实现 方法 也 提供 了 这 些 专 有 方法 ， 它 们 返 


true 或 false ° 


© $request-&gt; isGet() 
© $request-&gt;isPost() 
© $request-&gt;isPut() 
© $request-&gt;isDelete() 
© $request-&gt; isHead() 
© $request-&gt;isPatch() 


e $request-&gt;isOptions() 


还 可 以 伪造 或 履 写 这 些 HTTP 请 求 方法 。 这 非常 有 用 ， 例 如 你 需要 在 一 个 只 支持 GET 或 
post 请 求 的 传统 浏览 器 中 模拟 一 个 PUT 请 求 。 


有 两 种 方法 来 复写 HTTP 请 求 方法 。 你 可 以 在 一 个 post 请 求 体 中 引入 (include) 一 个 
_METHOD 参数 。 该 HTTP 请 求 必 须 使 用 application/x-www-form-urlencoded 内 容 类 型 
(content type) 。 

POST /path HTTP/1.1 

Host: example.com 

Content-type: application/x-www-form-urlencoded 


Content-length: 22 


data=value&_METHOD=PUT 


Figure 3: 使 用 METHOD #35 HTTP 请 求 。 


你 也 可 以 使 用 自 定义 的 X-Http-Method-override HTTPi# RARBS HTTP 请 求 方 法 。 这 个 


方式 可 以 用 于 任意 HTTP 请 求 内 容 类 型 (content type) ° 


POST /path HTTP/1.1 

Host: example.com 
Content-type: application/json 
Content-length: 16 
X-Http-Method-Override: PUT 


{"data":"value"} 


Figure 4: 使 用 X-Http-Method-Override % RAA Z HTTP 方法 。 


你 可 以 使 用 PSR 7 请 求 对 象 的 方法 getoriginalMethod() 来 提取 原 有 (PÆRE) 的 
HTTP 方法 。 


请 求 URI 


每 个 HTTP 请 求 都 有 一 个 识别 被 请 求 的 应 用 程序 资源 的 URI 。HTTP 请 求 URI 分 为 这 几 部 


分 : 


e Scheme (e.g. http or https ) 

e Host (e.g. example.com ) 

e Port(e.g. 80 or 443 ) 

e Path (e.g. /users/1 ) 

e Query string (e.g. sort=created&dir=asc ) 


你 可 以 使 用 geturi() 方法 来 提取 PSR 7 请 求 对 象 的 URI: 


$uri = $request->getUri(); 


PSR7 请 求 对 象 的 URI 本 身 就 是 一 个 对 象 ， 提 供 了 以 下 方法 来 检查 HTTP 请 求 的 URL : 


e@ getScheme() 

@ getAuthority() 

@ getUserInfo() 

e getHost() 

© getPort() 

e getPath() 

@ getBasePath() 

e getQuery() <small>( 返 回 整 个 查询 字符 囊 ，e.g. a=1&b=2 )</small> 
@ getFragment() 


@ getBaseUrl() 
基准 路 径 如 果 你 的 Slim 应 用 程序 的 前 端 控制 器 放置 在 文件 根 目 录 的 物理 子 目录 中 ， 你 可 以 使 


用 URI 对 象 的 getBasePath() 方法 来 提取 HTTP 请 求 的 物理 基准 路 径 (相对 于 文件 根 目 
录 ) 。 如 果 Slim 应 用 程序 安装 在 文件 根 目 录 的 最 上 层 目 录 中 ， 它 将 返回 一 个 空 字 符 串 。 


每 个 HTTP 请 求 都 有 请 求 头 。 这 些 元 数据 描述 了 HTTP 请 求 ， 但 在 请 求 体 中 不 可 见 。Slim 的 
PSR 7 请 求 对 象 提 供 了 几 个 检查 请 求 头 的 方法 。 


获取 所 有 请 求 头 


使 用 PSR 7 请 求 对 象 的 getHeaders() 方法 提取 所 有 HTTP 请 求 头 并 放 入 一 个 关联 数组 中 。 此 
关联 数组 的 键 值 是 请 求 头 的 名 称 ， 其 值 是 各 请 求 头 对 应 的 由 字符 串 值 组 成 的 数值 数组 。 


$headers = $request->getHeaders(); 
foreach ($headers as $name => $values) { 
echo $name . ": " . implode(", ", $values); 


} 
Figure 5: 提取 并 迭代 所 有 HTTP 请 求 头 作为 一 个 关联 数组 。 


获取 单个 请 求 头 


你 可 以 使 用 PSR 7 ARM RAY getHeader($name) 方法 获取 一 个 单独 的 请 求 头 的 值 。 它 将 返 
回 一 个 由 指定 请 求 头 名 称 对 应 的 值 组 成 的 数组 。 记 住 ， 单 独 的 请 求 头 可 不 一 定 只 有 一 个 值 。 


$headerValueArray = $request->getHeader('Accept'); 


Figure 6: 获取 指定 HTTP 请 求 的 值 。 


你 同样 可 以 使 用 PSR 7 请 求 对 象 的 getHeaderLine($name) 方法 提取 指定 请 求 头 的 值 ， 并 以 去 
号 分 隔 。 这 不 同 于 getHeader($name) 方法 ， 这 个 方法 返回 一 个 由 过 号 分 隔 的 字符 串 。 


$headerValueString = $request->getHeaderLine('Accept'); 
Figure 7: 获取 单个 请 求 头 的 值 ， 返 回去 号 分 隔 的 字符 囊 。 


令 测 请 求 头 
使 用 PSR 7 RA HAY hasHeader($name) 方法 检查 某 请 求 头 是 否 存 在 。 


if ($request->hasHeader('Accept')) { 
// Do something 
} 


Figure 8: Detect presence of a specific HTTP request header. 


请 求 体 


每 个 HTTP 请 求 都 有 一 个 请 求 体 。 如果 你 的 Slim 应 用 程序 是 通过 ISON 或 XML 数据 进行 通 
信 的 ， 你 可 以 使 用 PSR 7 请 求 对 象 的 getParsedBody() 方法 将 HTTP 请 求 体 解析 成 原生 
PHP 格式 。Slim 可 以 解析 JSON, XML, 和 URL-encoded 数据 ， 开 箱 即 用 。 


$parsedBody = $request->getParsedBody(); 


Figure 9: Parse HTTP request body into native PHP format 


e JSON 请 求 通过 json_decode($input) 转换 成 PHP 对 象 。 
e XML 请 求 通过 simplexml load string($input) 转换 成 simplexMLElement ° 
e URL-encoded 请 求 通过 parse_str($input) 转换 成 PHP 数组 。 


从 技术 上 说 ，Slim 的 PSR 7 请 求 对 象 将 HTTP 请 求 体 表示 为 
\Psr\Http\Message\StreamInterface 的 一 个 实例 。 你 可 以 通过 使 用 PSR7 请 求 对 象 的 
getBody() 方法 获取 HTTP 请 求 体 的 streamInterface 实例 。 该 getBody() 方法 在 处 理 未 
知 大 小 或 对 于 可 用 内 存 来 说 太 大 的 HTTP 请 求 时 ， 是 个 很 好 的 方法 。 


$body = $request->getBody(); 


Figure 10: 获取 HTTP 请 求 体 


生成 的 \Psr\Http\Message\StreamInter face 实例 提供 了 以 下 方法 来 读 取 或 迭代 未 知 的 


资源 (resource) ° 


© getSize() 

e tell() 

e eof() 

@ isSeekable() 
© seek() 

© rewind() 

e iswritable() 
© write($string) 
@ isReadable() 
© read($length) 
@ getContents() 


© getMetadata($key = null) 


请 求助 手 /Request Helpers 


Slim 的 PSR 7 请求 实现 方法 提供 了 额外 的 专 有 方法 来 帮助 你 进一步 检查 HTTP 请 求 。 


Am XHR is 


你 可 以 使 用 请 求 对 象 的 isxhr() 方法 来 检测 XHR 请 求 。 该 方法 检测 X-Requested-with 请 求 
头 ， 并 确保 它 的 值 是 XMLHttpRequest ° 


POST /path HTTP/1.1 

Host: example.com 

Content-type: application/x-www-form-urlencoded 
Content-length: 7 

X-Requested-with: XMLHttpRequest 


foo=bar 


Figure 11: XHR 请 求 示例 . 


if ($request->isxhr()) { 
// Do something 
} 


内 容 类 型 /Content Type 


你 可 以 使 用 请 求 对 象 的 getcontentType() 方法 提取 HTTP 请 求 的 内 容 类 型 。 它 将 通过 HTTP 
客户 端 返回 content-Type 头 的 完整 值 。 


$contentType = $request->getContentType(); 


媒体 类 型 /Media Type 


你 或 许 不 会 想 要 完整 的 Content-Type 头 。 加 入 说 你 只 想 要 媒体 类 型 ? 你 可 以 使 用 响应 对 象 的 
getMediaType() 方法 取得 HTTP 请 求 的 媒体 类 型 。 


$mediaType = $request->getMediaType(); 


可 以 使 用 请 求 对 象 的 getMediatypeParams() 方法 ， 以 关联 数组 的 形式 获取 附加 的 没 提 类 型 参 
数 。 


$mediaParams = $request->getMediaTypeParams(); 


字符 集 /Character Set 


HTTP 请 求 字符 集 是 最 常用 的 媒体 类 型 参数 之 一 。 请 求 对 象 提供 了 一 个 专用 的 方法 来 获取 这 个 
媒体 类 型 参数 。 


$charset = $request->getContentCharset(); 


内 容 长 度 /Content Length 
使 用 请 求 对 象 的 getcontentLength() 方法 获取 HTTP 请 求 的 内 容 长 度 。 


$length = $request->getContentLength(); 


路 由 对 象 [Route Object 
有 时 在 中 间 件 中 你 需要 路 由 的 参数 。 


在 这 个 例子 中 ， 我 们 首先 检查 用 户 是 否 登录 ， 然 后 检查 用 户 有 否 有 权限 浏览 他 们 正 试图 浏览 
的 视频 。 


$app->get('/course/{id}', Video::class.":watch")->add(Permission: :class)->add(Auth::class 
//.. In the Permission Class's Invoke 
/** @var $route \Slim\Route */ 


$route = $request->getAttribute('route'); 
$courseld = $route->getArgument('id'); 


本 —— 


媒体 类 型 解析 


如 果 HTTP 请 求 的 媒体 类 型 被 识别 ， 将 通过 $request-&gt;getParsedBody() 解析 成 为 结构 化 
的 可 用 数据 。 通 常 是 解析 成 一 个 数组 ， 或 者 是 XML 媒体 类 型 的 对 象 。 





以 下 媒体 类 型 是 可 识别 和 解析 的 : 


e application/x-www-form-urlencoded’ 
e application/json 
e application/xml & text/xml 


如 果 你 想 要 用 Slim 来 解析 其 它 媒体 类 型 ， 那 么 你 可 以 自行 解析 原生 的 HTTP 请 求 体 ， 或 者 新 
注册 一 个 媒体 解析 器 。 媒 体 解析 器 都 是 简单 的 callable ， 它 接收 一 个 $input 字符 串 并 返回 
一 个 解析 后 的 对 象 或 数组 。 

在 应 用 程序 或 者 路 由 中 间 件 中 注册 新 的 媒体 解析 器 。 注 意 ， 你 必须 在 首次 尝试 访问 解析 后 的 
HTTP 请 求 体 前 注册 该 解析 器 。 

例如 ， 要 自 动 解 析 带 有 text/javascript 内 容 类 型 的 JSON ， 你 可 以 像 这 样 在 中 间 件 中 注册 
媒体 解析 器 : 


// 添加 中 间 件 
$app->add(function ($request, $response, $next) { 
// add media parser 
$request ->registerMediaTypeParser ( 
"text/javascript", 
function ($input) { 
return json_decode($input, true); 
} 


); 


return $next($request, $response); 


}); 


HTTP 响应 


Slim 应 用 程序 的 路 由 和 中 间 件 给 出 了 一 个 PSR 7 响应 对 象 ， 它 表示 当前 的 HTTP 响应 将 被 返 
回 给 客户 端 。 该 响应 对 象 遵 循 PSR 7 响应 接口 实现 ， 因 此 你 可 以 检查 和 操作 该 HTTP 响应 的 
状态 、 响 应 头 和 响应 体 。 


如 何 获 取 HTTP 响应 对 象 
PSR 7 响应 对 象 作为 路 由 回调 的 第 二 个 参数 注入 到 Slim 应 用 程序 的 路 由 中 : 


<?php 
use Psr\Http\Message\ServerRequestinter face; 
use Psr\Http\Message\ResponseInter face; 


$app = new \Slim\App; 

$app->get('/foo', function (ServerRequestInterface $request, ResponseInterface $response) 
// Use the PSR 7 $response object 
return $response; 

3); 

$app->run(); 





Figure 1: Inject PSR 7 response into application route callback. 


PSR 7 请 求 对 象 作 为 中 间 件 callable 的 第 二 个 参数 注入 到 Slim 应 用 程序 的 中 间 件 : 


<?php 
use Psr\Http\Message\ServerRequestinter face; 
use Psr\Http\Message\ResponselInter face; 


$app = new \Slim\App; 

$app->add(function (ServerRequestInterface $request, ResponseInterface $response, callabl 
// Use the PSR 7 $response object 
return $next($request, $response); 


3); 
// Define app routes... $app->run(); 





Figure 2: Inject PSR 7 response into application middleware. 


HTTP 响应 状态 
每 个 HTTP 响应 都 有 一 个 数字 状态 编码 。 状 态 编码 用 于 识别 返回 客户 端的 HTTP 响应 的 类 
Alo PSR 7 响应 对 象 的 默认 状态 编码 是 200 (OK)。 你 可 以 像 这 样 使 用 getstatuscode() 方 


法 获取 PSR 7 响应 对 象 的 状态 编码 : 


$status = $response->getStatusCode(); 


Figure 3: Get response status code. 


你 可 以 拷贝 一 个 PSR7 响应 对 象 ， 并 指定 一 个 新 的 状态 编码 ， 像 这 样 : 


$newResponse = $response->withStatus(302); 


Figure 4: Create response with new status code. 


HTTP 响应 头 


每 个 HTTP 响应 都 有 其 相应 的 响应 头 。 这 些 元 数据 描述 了 HTTP 响应 ， 但 在 响应 体 中 不 可 
见 。Slim 的 PSR 7 响应 对 象 提供 了 几 种 检查 和 操作 响应 头 的 方法 。 


获取 所 有 响应 头 


使 用 PSR 7 响应 对 象 的 getHeaders() 方法 提取 所 有 HTTP 响应 头 并 存 入 一 个 关联 数组 中 。 
该 关联 数组 的 键 名 即 为 响应 头 的 名 称 ， 键 值 是 与 其 响应 头 对 应 的 值 的 字符 素数 组 。 


$headers = $response->getHeaders(); 
foreach ($headers as $name => $values) { 

echo $name . ": " . implode(", ", $values); 
} 


Figure 5: Fetch and iterate all HTTP response headers as an associative array. 


获取 单个 响应 头 


使 用 PSR 7 响应 对 象 的 getHeader($name) 方法 获取 单个 响应 头 的 值 。 它 将 返回 指定 响应 头 
的 值 组 成 的 数组 。 记 住 ， 单 个 HTTP 响应 不 止 一 个 值 。 


$headerValueArray = $response->getHeader('Vary'); 


Figure 6: Get values for a specific HTTP header. 


同样 ， 可 以 是 PSR 7 响应 对 象 的 getHeaderLine($name) 方法 获取 指定 响应 头 的 所 有 值 ， 由 过 
号 隔 开 。 不 同 于 getHeader($name) 方法 ， 此 方法 返回 的 是 由 过 号 隔 开 的 字符 串 。 


$headerValueString = $response->getHeaderLine('Vary'); 


Figure 7: Get single header's values as comma-separated string. 


检查 响应 头 


使 用 PSR 7 响应 对 象 的 hasHeader($name) 方法 检查 响应 头 存 在 与 否 。 


if ($response->hasHeader('Vary')) { 
// Do something 
} 


Figure 8: Detect presence of a specific HTTP header. 
设置 响应 头 
使 用 PSR 7 响应 对 象 的 withHeader($name, $value) 方法 设置 响应 头 的 值 。 


$newResponse = $oldResponse->withHeader('Content-type', '‘application/json'); 


Figure 9: Set HTTP header 


提示 响应 对 象 是 不 可 改 的 。 此 方法 返回 一 个 响应 对 象 的 拷贝 (copy) ， 它 拥有 新 的 值 。 此 方 
法 是 破坏 性 的 ， 它 替换 了 已 有 的 同名 响应 头 现 有 的 值 。 


追加 响应 头 /Append Header 


使 用 PSR 7 响应 对 象 的 withAddedHeader($name, $value) 方法 追加 一 个 响应 头 的 值 。 


$newResponse = $oldResponse->withAddedHeader('Allow', 'PUT'); 


Figure 10: Append HTTP header 


提示 不 同 于 withHeader() 方法 ， 此 方法 是 追加 (append) 新 的 值 到 响应 头 已 有 的 值 中 。 该 
响应 对 得 是 不 可 修改 的 。 此 方法 返回 一 个 已 添加 新 值 的 该 对 银 的 拷贝 。 


移 除 响应 头 
使 用 HTTP 响应 对 象 的 withoutHeader($name) 方法 移 除 响应 头 。 


$newResponse = $oldResponse->withoutHeader('Allow'); 


Figure 11: Remove HTTP header 


提示 响应 对 得 是 不 可 改 的 。 此 方法 返回 一 个 带 有 追加 的 响应 头 的 值 的 响应 对 象 的 拷贝 
(copy) ° 


HTTP 响应 体 


HTTP 响应 通常 有 一 个 响应 体 。Slim 提供 了 一 个 PSR 7 响应 对 象 ， 你 可 以 用 它 检查 或 操作 可 
能 会 有 的 响应 体 。 


类 似 PSR 7 请 求 对 象 ，PSR 7 响应 对 象 将 响应 体 作 为 \psr\Http\Message\StreamInterface 的 
实例 来 实现 。 你 可 以 使 用 PSR 7 响应 对 象 的 getBody() 方法 来 获取 HTTP 响应 体 
StreamInterface 的 实例 。 该 getBody() 方法 完美 适用 于 未 知 大 小 或 对 于 可 用 内 容 来 说 太 大 
的 输出 (outgoing) HTTP 响应 。 


$body = $response->getBody(); 


Figure 12: Get HTTP response body 


所 得 的 \psr\Http\Message\StreamInterface 实例 提供 以 下 方法 来 读 取 、 和 迭代 、 写 入 到 洪 在 的 
PHP 资源 (resource) ° 


e getSize() 

è tell() 

® eof() 

e isSeekable() 
e seek() 

@ rewind() 

e iswritable() 
©® write($string) 
@ isReadable() 
e read($length) 
e getContents() 


© getMetadata($key = null) 
大 多 数 情 况 下 ， 你 会 需要 写 入 到 PSR 7 响应 对 象 。 你 可 以 像 这 样 使 用 write() 方法 将 内 容 
写 入 到 streaminterface 实例 : 


$body = $response->getBody(); 
$body->write('Hello'); 


Figure 13: Write content to the HTTP response body 


你 同样 可 以 完整 新 建 一 个 streamInterface 实例 来 替换 PSR 7 响应 对 象 的 响应 体 。 这 玩意 特 
别 有 用 ， 尤 其 是 你 想 要 从 远程 地 址 传输 内 容 到 HTTP 响应 中 时 〈 例 如， 文件 系统 或 远程 
API) 。 你 可 以 使 用 withBody(StreamInterface $body) 方法 替换 PSR 7 响应 对 象 的 响应 体 。 


它 的 参数 必须 是 \Psr\Http\Message\Streaminter face 的 实例 。 


$newStream = new \GuzzleHttp\Psr7\LazyOpenStream('/path/to/file', 'r'); 
$newResponse = $o0ldResponse->withBody($newStream) ; 


Figure 14: Replace the HTTP response body 


提示 响应 对 象 不 可 改变 。 这 个 方法 返回 的 是 包含 新 响应 体 的 对 象 的 拷贝 (copy) 。 


返回 JSON 
Slim 的 响应 对 象 拥有 一 个 自 定义 方法 withison($data, $status, $encodingOptions) 来 帮助 优 
化 返回 JSON 数据 的 过 程 。 


其 中 $data 参数 包含 你 希望 返回 的 JSON 的 数据 结构 。 $status 是 可 选 的 ， 并 能 返回 一 个 
自 定义 的 HTTP 代码 。 $encodingoptions 是 可 选 的 ， 它 是 与 json encode() 相同 的 编码 选 
项 o 


最 简单 的 形式 ， 可 以 返回 带 上 默认 的 200 HTTP 状态 代码 的 JSON 数据 。 


$data = array('name' => 'Bob', 'age' => 40); 
$newResponse = $oldResponse->withJson($data) ; 


Figure 15: Returning JSON with a 200 HTTP status code. 


还 可 以 返回 带 有 自 定 义 HTTP 状态 码 的 JSON 数据 。 


$data = array('name' => 'Rob', 'age' => 40); 
$newResponse = $oldResponse->withJson($data, 201); 


Figure 16: Returning JSON with a 201 HTTP status code. 
HTTP 响应 的 Content-Type 自动 设置 为 application/json;charset=utf-8 ° 


如 果 JSON 存在 数据 编码 问题 ， \RuntimeException($message, $code) 将 抛 出 异常 ， 包含 将 
json_last_error_msg() 的 值 作为 $message 的 值 以 及 将 json_last_error() 作为 the 
$code 的 值 。 


提示 响应 对 象 是 不 可 改 的 。 此 方法 返回 一 个 响应 对 象 的 拷贝 (copy) ， 该 捞 贝 带 有 新 的 


Content-Type 头 。 该 方法 是 毁灭 性 的 ， 它 将 替换 (replaces) 已 存在 的 Content-Type 头 。 当 
withJson() 被 调用 ， 如 果 传递 了 $status > HTTP 状态 码 也 会 被 替换 。 


路 由 


Slim 框架 的 路 由 基于 nikic/fastroute 组 件 进行 构建 ， 它 格外 地 快速 稳定 。 


如 何 创 建 路 由 


你 在 可 以 使 用 \slim\App 实例 的 代理 (proxy) 方法 来 定义 应 用 程序 路 由 。Slim 框架 提供 了 
最 流行 的 HTTP 方 法 。 


Get 路 由 


使 用 Slim 应 用 程序 的 get() 方法 添加 一 个 只 处 理 GET HTTP 请 求 的 路 由 。 它 接收 两 个 参 
数 : 


1. 路 由 模式 ( 带 有 可 选 的 命名 占 位 符 ) /The route pattern (with optional named 
placeholders) 
2. 路 由 回调 


$app = new \Slim\App(); 

$app->get('/books/{id}', function ($request, $response, $args) { 
// Show book identified by $args['id'] 

}); 


POST 路 由 


使 用 Slim 应 用 程序 的 post() 方法 添加 一 个 只 处 理 post HTTP 请 求 的 路 由 。 它 接收 两 个 参 
数 : 


1. 路 由 模式 ( 带 有 可 选 的 命名 占 位 符 ) /The route pattern (with optional named 
placeholders) 
2. 路 由 回调 


$app = new \Slim\App(); 
$app->post('/books', function ($request, $response, $args) { 
// Create new book 


3); 


PUT 路 由 


使 用 Slim 应 用 程序 的 put() 方法 添加 一 个 只 处 理 put HTTP 请 求 的 路 由 。 它 接收 两 个 参 
RL: 


1. 路 由 模式 〈 带 有 可 选 的 命名 占 位 符 ) /The route pattern (with optional named 
placeholders) 
2. 路 由 回调 


$app = new \Slim\App(); 

$app->put('/books/{id}', function ($request, $response, $args) { 
// Update book identified by $args['id'] 

}); 


DELETE 路 由 


使 用 Slim 应 用 程序 的 delete() 方法 添加 一 个 只 处 理 DELETE HTTP 请 求 的 路 由 。 它 接收 两 
个 参数 : 


1. 路 由 模式 〈 带 有 可 选 的 命名 占 位 符 ) /The route pattern (with optional named 
placeholders) 
2. 路 由 回调 


$app = new \Slim\App(); 

$app->delete('/books/{id}', function ($request, $response, $args) { 
// Delete book identified by $args['id'] 

3); 


OPTIONS 路 由 


使 用 Slim 应 用 程序 的 options() 方法 添加 一 个 只 处 理 options HTTP 请 求 的 路 由 。 它 接收 
两 个 参数 : 


1. 路 由 模式 〈 带 有 可 选 的 命名 占 位 符 ) /The route pattern (with optional named 
placeholders) 
2. 路 由 回调 


$app = new \Slim\App(); 
$app->options('/books/{id}', function ($request, $response, $args) { 
// Return response headers 


3); 


PATCH 路 由 
使 用 Slim 应 用 程序 的 patch 方法 添加 一 个 只 处 理 patch HTTP 请 求 的 路 由 。 它 接收 两 个 
BR: 


1. 路 由 模式 〈 带 有 可 选 的 命名 占 位 符 ) /The route pattern (with optional named 
placeholders) 
2. 路 由 回调 


$app = new \Slim\App(); 
$app->patch('/books/{id}', function ($request, $response, $args) { 
// Apply changes to book identified by $args['id'] 


3); 


任意 路 由 


使 用 Slim 应 用 程序 的 any() 方法 添加 一 个 可 以 处 理 处 理 所 有 HTTP 请 求 的 路 由 。 它 接收 两 
个 参数 : 


1. 路 由 模式 〈 带 有 可 选 的 命名 占 位 符 ) /The route pattern (with optional named 
placeholders) 
2. 路 由 回调 


$app = new \Slim\App(); 

$app->any('/books/[{id}]', function ($request, $response, $args) { 
// Apply changes to books or book identified by $args['id'] if specified. 
// To check which method is used: $request->getMethod(); 


3); 


记 住 ， 第 二 个 参数 是 一 个 回调 。 你 需要 指定 一 个 类 (Class， 需 要 一 个 _invoke() LMA 
法 。) RRMA (Closure) 。 接 着 ， 你 可 以 映射 到 其 他 位 置 : 


$app->any('/user', 'MyRestfulController'); 


自 定 义 路 由 


使 用 Slim 应 用 程序 的 map() 方法 来 添加 一 个 可 以 处 理 多 个 HTTP 请 求 方法 的 路 由 。 它 接收 
三 个 参数 : 


1. HTTP 方法 的 数组 
2. 路 由 模式 〈 带 有 可 选 的 命名 占 位 符 ) /The route pattern (with optional named 
placeholders) 
3， 路 由 回调 
$app = new \Slim\App(); 
$app->map(['GET', 'POST'], '/books', function ($request, $response, $args) { 


// Create new book or list all books 


3); 


3S h EA 


上 述 的 每 个 路 由 方法 都 接收 一 个 回调 例 程 作 为 其 最 后 一 个 参数 。 这 个 参数 可 以 是 任意 PHP 调 
用 (callable) ， 并 且 它 默认 接受 三 个 参数 。 


请 求 /Request 


第 一 个 参数 是 一 个 psr\Http\Message\ServerRequestInterface 对 象 ， 表 示 当 前 的 HTTP 请 


响应 /Response 
第 二 个 参数 是 一 个 psr\Http\Message\ResponseInterface 对 象 ， 表 示 当 前 的 HTTP 响应 。 
参数 数组 /Arguments 


第 三 个 参数 是 一 个 关联 数组 ， 包 含 包 含 当前 路 由 的 命名 占 位 符 。 


将 内 容 写 入 响应 


ee ee 
出 内 容 。 其 内 容 将 会 喘 追 加 到 当前 HTTP 请 求 对 象 中 。 第 二 种 ， 你 可 以 返回 一 个 


Psr\Http\Message\ResponseInterface 对 象 3 


闭 包 绑 定 /Closure binding 


如 果 你 使 用 一 个 闭 包 (closure) 实例 作为 路 由 回调 ， 闭 包 的 状态 受 container 实例 约束 。 这 
意味 着 你 将 通过 $this 关键 字 访问 财 包 内 部 的 DI 容器 实例 : 


$app = new \Slim\App(); 
$app->get('/hello/{name}', function ($request, $response, $args) { 
// Use app HTTP cookie service 

$this->get('cookies')->set('name', [ 

"name' => $args['name'], 

‘expires' => '7 days' 

]); 
3); 


3B RS 


路 由 回调 签名 由 路 由 策略 决定 。 默 认 地 ，Slim 寄 望 路 由 回调 来 接收 请 求 、 响 应 和 由 路 由 占 位 
符 参 数组 成 的 数组 。 这 称 为 请 求 响 应 策略 (RequestResponse strategy) 。 然 而 ， 你 可 以 通 
过 使 用 另 一 个 不 同 策略 来 改变 这 种 寄 望 。 例 如 ，Slim 提供 了 一 个 另类 的 策略 ， 叫 做 
RequestResponseArgs , 它 接 收 请 求 和 响应 ， 加 上 由 每 一 个 路 由 占 位 符 组 成 的 单独 参数 。 这 里 
的 例子 展示 了 如 何 使 用 这 个 另类 的 策 列 ; 轻 松 替代 了 默认 \slim\container 提供 的 
foundHandler 依赖 : 


$c = new \Slim\Container(); 
$c['foundHandler'] = function() { 
return new \Slim\Handlers\Strategies\RequestResponseArgs(); 


J; 

$app = new \Slim\App($c); 

$app->get('/hello/{name}', function ($request, $response, $name) { 
return $response->write($name); 


}); 


通过 实现 \slim\Interfaces\Invocationst rategyInterface 你 可 以 提供 一 个 你 自己 的 路 由 策 


略 ° 


路 由 占 位 符 


上 诉 的 每 个 路 由 方法 都 会 收 到 一 个 URL 模式 (URL pattern) ， 它 将 与 当前 HTTP 请 求 的 
URI 相 匹 配 。 路 由 模式 将 使 用 命名 占 位 符 (named placeholder) 来 动态 匹配 HTTP 请 求 的 
URI 片段 。 


格式 


路 由 模式 占 位 符 起 始 与 一 个 {， 然 后 是 占 位 符 名 称 , 最 后 以 } 结束 。 这 是 一 个 名 为 name 的 
占 位 符 例 子 : 

$app = new \Slim\App(); 

$app->get('/hello/{name}', function ($request, $response, $args) { 


echo "Hello, " . $args['name']; 


3); 


可 选 的 分 段 | Optional segments 
使 一 个 片段 可 选 ， 只 需 用 将 其 放 在 方 括号 中 : 


$app->get('/users[/{id}]', function ($request, $response, $args) { 
// reponds to both ~/users~ and `/users/123` 
// but not to ~/users/~ 


3); 


KA SRTRERRE : 


$app->get('/news[/{year}[/{month}]]', function ($request, $response, $args) { 
// reponds to `/news`, ~/news/2016~ and ~/news/2016/03~ 
3); 


对 于 数目 不 确定 的 可 选 参数 ， 可 以 这 样 做 : 


$app->get('/news[/{params:.*}]', function ($request, $response, $args) { 
$params = explode('/', $request->getAttribute('params')); 


// $params is an array of all the optional segments 


3); 


在 这 个 例子 中 ， /news/2016/03/20 的 URI 将 使 得 $params 数组 包含 三 个 元 


素 : ['2016', '03', '20']. 


正则 表达 式 匹 配 


默认 地 ， 占 位 符 被 写 在 {} 之 中 ， 并 可 以 接收 任意 值 。 然 而 ， 占 位 符 同样 可 以 要 求 HTTP 请 
URI 匹配 特定 的 正则 表达 式 。 如 果 当 前 的 HTTP 请 求 URI 不 能 与 占 位 符 的 正则 表达 式 匹 
配 ， 路 由 路 由 将 不 会 启动 。 下 面 这 个 示例 占 位 符 要 求 id 必须 是 个 数字 : 


$app = new \Slim\App(); 

$app->get('/users/{id:[0-9]+}', function ($request, $response, $args) { 
// Find user identified by $args['id'] 

}); 


路 由 名 称 


应 用 程序 的 路 由 可 以 被 指定 一 个 名 称 。 这 非常 有 用 ， 如 果 你 想 要 使 用 路 由 的 pathFor() 方法 
以 编程 的 形式 生成 一 个 特定 路 由 的 URL 。 上 述 的 每 个 路 由 方法 都 会 返回 一 个 \slim\Route 对 
象 ， 这 个 对 象 带 来 了 setName() 方法 。 


$app = new \Slim\App(); 

$app->get('/hello/{name}', function ($request, $response, $args) { 
echo "Hello, " . $args['name']; 

})->setName('hello'); 


使 用 应 用 程序 路 由 的 pathFor() 方法 ， 为 已 命名 的 路 由 生成 一 个 URL e 


echo $app->router->pathFor('hello', [ 
'name' => 'Josh' 


]); 
// Outputs "/hello/Josh" 


路 由 的 pathFor() 方法 接收 两 个 参数 : 


1， 路 由 名 称 
2， 由 路 由 模式 占 位 符 及 替换 值 组 成 的 关联 数组 。 


路 由 组 


为 了 帮助 将 路 由 整理 成 条 理 分 明 的 路 由 组 ， \slim\App 还 提供 了 一 个 group) 方法 。 每 个 
路 由 组 的 路 由 模式 预 置 于 路 由 或 路 由 组 中 的 路 由 组 ， 路 由 组 模式 的 任何 占 位 符 参数 最 终 使 得 
诅 套 的 路 由 都 是 可 用 的 : 


$app = new \Slim\App(); 

$app->group('/users/{id:[0-9]+}', function () { 
$this->map(['GET', 'DELETE', 'PATCH', 'PUT'], '', function ($request, $response, $args) 
// Find, delete, patch or replace user identified by $args['id'] 
})->setName('user'); 

$this->get('/reset-password', function ($request, $response, $args) { 
// Route for /users/{id: [0-9]+}/reset -password 
// Reset the password for user identified by $args['id'] 
})->setName('user-password-reset'); 


J); 
RR 


记 住 ， 在 路 由 组 闭 包 的 内 部 ， 使 用 $this 替代 sapp ° Slim 将 闭 包 绑 定 到 应 用 程序 实例 ， 
就 像 路 由 回调 的 情况 那样 。 


路 由 中 间 件 
你 可 以 将 中 间 件 与 任意 路 由 或 路 由 组 相连 接 。 了 解 更 多 . 


v 


容器 识别 / Container Resolution 


你 不 必 限 于 为 路 由 定义 函数 。 在 Slim 中 ， 有 一 些 不 同 的 方式 来 定义 你 的 路 由 行为 函数 。 
RT Baap > WIE YT VASA: - 可 调用 的 类 - class:method 


这 个 函数 由 Slim 的 Callable 解 角 器 (Resolver) 类 提供 支持 。 它 将 字符 串 入 口 (entry) 转 
变 为 函数 调用 。 例 如 : 


$app->get('/home', '\HomeController:home' ); 


在 上 面 这 段 代 码 中 ， 我 们 定义 了 一 个 /home 路 由 ， 并 告诉 Slim 执行 \Homecontroller 类 中 
的 home() 方法 。 


Slim 首先 在 容器 中 寻找 \Homecontroller 的 入 口 ， 如 果 找 到 了 ， 它 将 使 用 该 实例 。 否 则 ， 它 
将 它 的 构造 函数 ， 并 将 容器 作为 第 一 个 和 参数。 一 旦 这 个 类 的 实例 创建 了 ， 它 将 使 用 你 已 定义 
IRH (Strategy) 去 调用 指定 的 方法 。 


作为 另 一 种 办 法 ， 你 可 以 使 用 一 个 可 调用 的 (invokable) 类 ， 比 如 : 


class MyAction { 
protected $ci; 
//Constructor 
public function __construct(ContainerInterface $ci) { 
$this->ci = $ci; 
} 


public function __invoke($request, $response, $args) { 
//your code 
//to access items in the container... $this->ci->get(''); 


你 可 以 这 样 使 用 这 个 累 : 


$app->get('/home', '\MyAction'); 


在 更 为 传统 的 MVC 方法 中 ， 你 构建 包含 许多 行为 (actions) 的 控制 器 来 替代 只 能 处 理 一 个 
行为 的 可 调用 类 。 


class MyController { 
protected $ci; 
//Constructor 
public function __construct(ContainerInterface $ci) { 
$this->ci = $ci; 
} 


public function methodi($request, $response, $args) { 
//your code 
//to access items in the container... $this->ci->get(''); 


} 


public function method2($request, $response, $args) { 
//your code 
//to access items in the container... $this->ci->get(''); 


} 


public function method3($request, $response, $args) { 
//your code 
//to access items in the container... $this->ci->get(''); 


你 可 以 这 样 使 用 控制 器 方法 : 


$app->get('/method1', '\MyController:method1'); 
$app->get('/method2', '\MyController:method2'); 
$app->get('/method3', '\MyController:method3' ); 


错 i 
处 理 


500 系统 错误 处 理 器 
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出 问题 了 ! 你 并 不 能 预知 错误 ， 但 你 可 以 预料 到 。 每 个 Slime 框架 应 用 程序 都 有 一 个 错误 处 
ee 
响应 对 象 。 错误 处 理 器 必须 预备 并 返回 一 个 适当 的 响应 对 象 ， 这 个 对 象 会 被 返回 到 HTTP 
客户 端 。 


默认 的 错误 处 理 器 


默认 的 错误 处 理 器 非常 基础 。 它 将 响应 状态 编码 设置 为 s00 ， 并 将 响应 内 容 类 型 设置 为 
text/html ， 并 将 一 个 通用 的 错误 信息 加 入 到 响应 体 中 。 


这 个 对 于 生产 应 用 大 概 不 太 合适 。 强 烈 建议 你 实现 专用 于 你 的 Slim 应 用 程序 的 错误 处 理 器 。 


默认 的 错误 处 理 程序 还 可 以 包括 详细 的 错误 诊断 信息 。 要 启用 这 个 功能 你 需要 将 
displayErrorDetails 设置 为 true : 


$configuration = [ 
'settings' => [ 
'displayErrorDetails' => true, 
1, 
]; 
$c = new \Slim\Container($configuration) ; 
$app = new \Slim\App($c); 


自 定义 错误 处 理 器 


Slim 框架 应 用 程序 的 错误 处 理 器 是 一 种 Pimple 服务 。 你 可 以 通过 应 用 程序 容器 对 自 定义 
Pimple factory 方法 进行 定义 ， 来 创建 自 定 义 的 错误 处 理 器 取代 默认 的 。 


有 两 种 注入 处 理 器 的 方法 : 


Pre App 


$c = new \Slim\Container(); 

$c['errorHandler'] = function ($c) { 
return function ($request, $response, $exception) use ($c) { 
return $c['response' ]->withStatus(500) 
->withHeader('Content-Type', 'text/html') 
->write('Something went wrong!'); 


ti 
$app = new \Slim\App($c); 


Post App 


$app = new \Slim\App(); 
$c = $app->getContainer(); 
$c['errorHandler'] = function ($c) { 
return function ($request, $response, $exception) use ($c) { 
return $c['response' ]->withStatus(500) 
->withHeader('Content-Type', 'text/html') 
->write('Something went wrong!'); 
ti 


在 这 个 例子 中 ， 我 们 定义 了 一 个 新 的 errorHandler factory ， 它 将 返回 一 个 callable 。 返 回 
的 callable 接收 三 个 参数 : 


1 二 个 \Psr\Http\Message\ServerRequestinterface 实例 
2 \Psr\Http\Message\ResponselInterface 实例 


3. 一 个 \Exception 实例 


这 个 callable 必须 返回 一 个 新 的 \Psr\Http\Message\ResponseInterface 实例 ， 对 于 给 定 的 异 
常 也 是 如 此 。 


务必 注意 : 下 面 这 三 个 类 型 的 异常 不 会 被 自 定义 的 errorHandler 处 理 : 


@ Slim\Exception\MethodNotAllowedException : 这 个 可 以 用 自 定义 的 notAllowedHandler 来 
处 理 。 

@ Slim\Exception\NotFoundException : 这 个 可 以 用 自 定义 的 notFoundHandler 来 处 理 。 

e slim\Exception\SlimException : 这 种 类 型 的 异常 是 Slim 内 置 的 ， 它 的 处 理 不 能 被 覆 写 。 


要 想 彻 底 地 禁用 Slim 的 错误 处 理 器 ， 只 需 从 容器 中 移 除 错误 处 理 器 即 可 : 


unset ($app->getContainer()['errorHandler']); 


现在 ， 你 需要 负责 处 理 所 有 弄 常 了 ， 因 为 Slim 已 经 不 再 处 理 它们 。 


404 Not Found #24 
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如 果 你 的 Slim 应 用 程序 没有 可 以 匹配 到 当前 HTTP 请 求 URI 的 路 由 ， 程 序 会 调用 Not Found 
处 理 器 ， 并 返回 一 个 HTTP/1.1 404 Not Found 响应 到 HTTP 客户 端 。 


默认 的 Not Found 2324 


每 个 Slim 框架 应 用 程序 都 有 一 个 默认 的 Not Found 处 理 器 。 这 个 处 理 器 将 响应 状态 设置 为 
404 ， 并 将 内 容 类 型 设置 为 text/html ， 它 将 写 入 一 个 简单 的 异常 信息 到 响应 体 。 


自 定义 Not Found 2224 


Slim 框架 应 用 程序 的 Not Found 处 理 器 是 一 个 Pimple 服务 。 你 可 以 通过 应 用 程序 容器 对 自 
定义 Pimple factory 方法 进行 定义 ， 来 创建 自 定 义 的 Not Found 处 理 器 取代 默认 的 。 


$c = new \Slim\Container(); //Create Your container 


//Override the default Not Found Handler 
$c['notFoundHandler'] = function ($c) { 

return function ($request, $response) use ($c) { 
return $c['response' ] 

->withStatus(404) 

->withHeader('Content-Type', 'text/html1') 
->write('Page not found'); 

}; 


六 


//Create Slim 
$app = new \Slim\App($c); 


//... Your code 
在 这 个 例子 中 ， 我 们 定义 了 一 个 新 的 notFoundHandler factory ， 它 将 返回 一 个 callable ° % 
回 的 callable 接收 2 个 参数 : 


1 一 个 \Psr\Http\Message\ServerRequestInterface 实例 


2. = \Psr\Http\Message\ResponselInterface 实例 


这 个 callable 必须 返回 一 个 恰当 的 \Psr\Http\Message\ResponseInterface 实例 。 


405 Not Allowed 2224 
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如 果 你 的 Slim 框架 应 用 程序 有 一 个 路 由 匹配 到 了 当前 的 HTTP 请 求 URI 而 非 HTTP 请 求 方 
法 ， 程 序 将 调用 Not Allowed 处 理 器 并 返回 一 个 HTTP/1.1 405 Not Allowed 响应 到 HTTP & 
户 端 。 


默认 的 Not Allowed 2 32 #8 


每 个 Slim 框架 应 用 程序 都 有 一 个 默认 的 Not Allowed 处 理 器 。 该 处 理 器 将 HTTP 响应 状态 设 
BA 405 ， 将 内 容 类 型 设置 为 text/html ， 它 还 会 添加 一 个 包含 由 过 号 分 隔 的 已 被 允许 访问 
的 HTTP 方法 组 成 的 列表 的 Allowed: HTTP 头 它 还 会 在 HTTP 响应 体 中 写 入 一 个 简单 的 注 


自 定义 Not Allowed 处 理 器 


Slim 框架 应 用 程序 的 Not Allowed 处 理 器 是 一 个 Pimple 服务 。 你 可 以 通过 应 用 程序 容器 对 自 
定义 Pimple factory 方法 进行 定义 ， 来 创建 自 定义 的 Not Allowed 处 理 器 取代 默认 的 


// Create Slim 

$app = new \Slim\App(); 

// get the app's di-container 

$c = $app->getContainer(); 

$c['notAllowedHandler'] = function ($c) { 
return function ($request, $response, $methods) use ($c) { 
return $c['response' ] 
->withStatus(405) 
->withHeader('Allow', implode(', ', $methods)) 
->withHeader('Content-type', 'text/html') 

->write('Method must be one of: ' . implode(', ', $methods)); 


}; 
注意 Check out Not Found docs for pre-slim creation method using a new instance of 


\Slim\Container 


在 这 个 例子 中 ， 我 们 定义 了 一 个 新 的 notAllowedHandler factory ， 它 将 返回 一 个 callable 。 
返回 的 callable 接收 两 个 参数 : 


1 二 小 \Psr\Http\Message\ServerRequestinterface 实例 
2 = \Psr\Http\Message\ResponselInterface 实例 
3. 一 个 由 已 允许 访问 的 HTTP 方法 名 组 成 的 数组 


这 个 callable 必须 返回 一 个 恰当 的 \Psr\Http\Message\ResponseInterface 实例 。 


以 | 结尾 的 路 由 模式 
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Slim 处 理 带 有 和 斜 线 结尾 的 URL 和 不 带 斜 线 的 URL 的 方式 不 同 。 意 思 就 是 /user 和 /user/ 
不 是 一 回 事 ， 它 们 可 以 有 不 同 的 回调 。 


如 果 你 想 通 过 重 定向 让 所 有 以 / 结尾 的 URL 和 不 以 / 结尾 的 URL 相等 ， 你 可 以 添加 这 个 
中 间 件 : 


use Psr\Http\Message\RequestInterface as Request; 
use Psr\Http\Message\ResponseInterface as Response; 


$app->add(function (Request $request, Response $response, callable $next) { 
$uri = $request->getUri(); 
$path = $uri->getPath(); 
if ($path != '/' && substr($path, -1) == '/') { 
// permanently redirect paths with a trailing slash 
// to their non-trailing counterpart 
$uri = $uri->withPath(substr($path, ©, -1)); 
return $response->withRedirect((string)$uri, 301); 


} 


return $next($request, $response); 


H; 


或 者 ， 也 可 以 使 用 oscarotero/psr7-middlewares’ TrailingSlash 中 间 件 强制 为 所 有 URL 添加 
结尾 的 斜 线 : 


use Psr7Middlewares\Middleware\TrailingSlash; 


$app->add(new TrailingSlash(true)); // true 则 添加 结尾 斜 线 (false PRR) 


检索 IP 地 址 


检索 客户 端 当 前 IP 地 址 的 最 佳 方式 ， 是 利用 使 用 了 类 似 rka-ip-address-middleware 这 种 组 件 
的 中 间 件 。 


这 个 组 件 可 以 通过 Composer 来 安装 : 


composer require akrabat/rka-ip-address-middleware 


要 使 用 这 个 组 件 ， 需 要 使 用 app 注册 中 间 件 ， 这 里 提供 了 一 个 可 信赖 的 代理 列表 (eg. 
varnish 服务 器 ) ,如 果 你 再 使 用 它们 : 

$checkProxyHeaders = true; 

$trustedProxies = ['10.0.0.1', '10.0.0.2']; 


$app->add(new RKA\Middleware\IpAddress($checkProxyHeaders, $trustedProxies) ); 


$app->get('/', function ($request, $response, $args) { 
$ipAddress = $request->getAttribute('ip_address'); 


return $response; 


3); 


这 个 中 间 件 把 客户 端 IP 地 址 存储 在 一 个 HTTP 请 求 属性 中 ， 所 以 需要 通过 


$request -&gt;getAttribute('ip_address') 来 访问 。 


检索 当前 路 由 


如 果 你 需要 在 应 用 程序 中 获取 当前 的 路 由 ， 你 所 需要 做 但 就 是 ， 调 用 HTTP 请 求 类 的 带 有 
‘route’ 参数 的 getAttribute 方法 ， 它 将 返回 当前 的 路 由 ， 这 个 路 由 是 slim\Route 类 的 


实例 。class. 


可 以 使 用 getName() 获取 路 由 的 名 称 ， 或 者 使 用 getMethods() 获取 此 路 由 支持 的 方法 ， 
etc ° 


Note: 如 果 你 需要 在 app 中 间 件 中 访问 路 由 ， 必 须 在 配置 中 将 
'determineRouteBeforeAppMiddleware' KAA true ° F > getAttribute('route') 将 会 返回 


null。 该 路 由 在 路 由 中 间 件 中 永远 可 用 。 


Example: 


use Slim\Http\Request; 
use Slim\Http\Response; 
use Slim\App; 


$app = new App([ 
"settings' => [ 
// Only set this if you need access to route within middleware 
"determineRouteBeforeAppMiddleware' => true 


1) 


// routes... 
$app->add(function (Request $request, Response $response, callable $next) { 
$route = $request->getAttribute('route'); 
$name = $route->getName(); 
$groups = $route->getGroups(); 
$methods = $route->getMethods(); 
$arguments = $route->getArguments(); 


// do something with that information 


return $next($request, $response); 


3); 


在 Slim 中 使 用 Eloquent 


你 可 以 使 用 Eloquent 这 种 数据 库 ORM 将 你 的 Slim 应 用 程序 连接 到 数据 库 。 


为 你 的 应 用 程序 添加 Eloquent 
composer require illuminate/database "~5.1" 


Figure 1: Add Eloquent to your application. 


配置 Eloquent 


在 Slim 的 setting 数组 中 添加 数据 库 设 置 项 。 


<?php 
return [ 
"settings' => [ 
// Slim Settings 
"determineRouteBeforeAppMiddleware' => false, 
"displayErrorDetails' => true, 
"db' => [ 
‘driver' => 'mysql', 
"host' => 'localhost', 
‘database' => 'database', 
‘username' => 'user', 
‘password’ => 'password', 


"charset' => 'utf8', 
'collation' => 'utf8_unicode_ci', 
'prefix' => ll, 


], 


Figure 2: Settings array. 
在 dependencies.php 中 ， 或 者 其 他 任意 位 置 添加 你 的 Service Factories: 


// Service factory for the ORM 

$container['db'] = function ($container) { 
$capsule = new \Illuminate\Database\Capsule\Manager; 
$capsule->addConnection($container['settings']['db']); 


$capsule->setAsGlobal(); 
$capsule->bootEloquent(); 


return $capsule; 


}; 


Figure 3: Configure Eloquent. 


传递 数据 表 实 例 到 控制 器 


$container [App\WidgetController::class] = function ($c) { 


}; 


$view = $c->get('view'); 

$logger = $c->get('logger') 

$table = $c->get('db')->table('table_name'); 

return new \App\WidgetController($view, $logger, $table); 


Figure 4: Pass table object into a controller. 


从 控制 器 中 查询 数据 衣 


<?php 


namespace App; 


use 
use 
use 
use 
use 


Slim\Views\Twig; 

Psr\Log\LoggerInterface; 
Illuminate\Database\Query\Builder; 
Psr\Http\Message\ServerRequestiInterface as Request; 
Psr\Http\Message\ResponseInterface as Response; 


class WidgetController 


{ 


private $view; 
private $logger; 
protected $table; 


public function __construct( 
Twig $view, 
LoggerInterface $logger, 
Builder $table 

Diet 
$this->view = $view; 
$this->logger = $logger; 
$this->table = $table; 


} 
public function __invoke(Request $request, Response $response, 
{ 
$widgets = $this->table->get(); 
$this->view->render($response, 'app/index.twig', [ 
"widgets' => $widgets 
]); 
return $response; 
} 


Figure 5: Sample controller querying the table. 


使 用 where 查询 数据 表 


$args ) 


$records = $this->table->where('name', 'like', '%fo0%')->get(); 


Figure 6: Query searching for names matching foo. 
通过 id 查询 数据 表 
$record = $this->table->find(1); 


Figure 7: Selecting a row based on id. 


了 解 更 多 


Eloquent 文档 


附加 组 件 


模板 


Slim 没有 传统 MVC 框架 的 视图 (view) Æ ° MA > Slim 的 “视图 "就 是 HTTP 响应。Slim 应 
用 程序 的 每 个 路 由 都 为 准备 和 返回 恰当 的 PSER 7 响应 对 象 负责 。 


Slim’s “view” is the HTTP response. 


话 虽 如 此 ， 但 Slim 项 目 提 供 了 Twig-View 和 PHP-View 组 件 帮 助 你 将 模版 泻 染 为 PSR7 响应 
xt Be o 
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Twig-View PHP 组 件 帮助 你 泻 染 应 用 程序 中 的 Twig 模版 。 这 个 组 件 可 以 在 Packageist L 
到 。 可 以 像 这 样 使 用 composer 轻易 地 安装 : 


composer require slim/twig-view 


Figure 1: Install slim/twig-view component. 
下 一 步 ， 你 需要 在 Slim 应 用 容器 中 将 此 组 将 注册 为 服务 ， 像 这 样 : 


<?php 
// Create app $app = new \Slim\App(); 


// Get container $container = $app->getContainer(); 


// Register component on container $container['view'] = function ($container) { 
$view = new \Slim\Views\Twig('path/to/templates', [ 
"cache' => 'path/to/cache' 


]); 

$view->addExtension(new \Slim\Views\TwigExtension( 
$container['router'], 
$container['request']->getUri() 


)); 


return $view; 


}; 


Figure 2: Register slim/twig-view component with container. 


记 住 :“cache” 可 以 设置 为 false $A È > ‘auto_reload’ 选项 也 是 如 此 ， 这 在 开发 环境 中 很 有 
用 。 了 解 更 多 信息 ， 查 阅 : Twig environment options 


现在 你 可 以 使 用 应 用 程序 内 部 的 slim/twig-view 组 件 服务 并 将 其 写 入 到 PSR 7 响应 对 象 
中 ， 像 这 样 : 


// Render Twig template in route 
$app->get('/hello/{name}', function ($request, $response, $args) { 
return $this->view->render($response, 'profile.html', [ 
"name' => $args['name'] 
]); 
})->setName('profile'); 


// Run app 
$app->run(); 


Figure 3: Render template with slim/twig-view container service. 


在 这 个 例子 中 ， 在 路 由 回调 中 被 调用 的 $this-&gt;view ， 是 容器 服务 返回 的 
\Slim\Views\Twig 实例 的 一 个 参考 (reference ) ° \Slim\Views\Twig 实例 的 render() 方 
法 接收 一 个 PSR7 响应 对 象 作为 它 的 第 一 个 参数 ，Twig 模版 路 径 作为 它 的 第 二 个 参数 ， 模 板 
变量 的 数组 作为 它 的 最 后 一 个 参数 。 这 个 render() 方法 返回 一 个 新 的 PSR7 响应 对 象 ， 它 

的 响应 体 是 由 Twig 模版 演 染 的 。 


path_for() 方法 


slim/twig-view 组 件 为 Twig 模版 暴露 了 一 个 自 定 义 path_for() HR o UR VE RK H 
数 生成 完整 的 指向 应 用 程序 中 任意 已 命名 路 由 的 URL 。 path_for() 函数 接收 两 个 参数 : 


1. 路 由 名 称 
2， 路 由 占 位 符 和 替换 值 的 散 列 (hash) 


第 二 个 参数 的 关键 字 须 与 已 选择 的 路 由 的 模式 占 位 符 一 致 。 这 是 一 个 示例 的 Twig 模版 ， 它 描 
述 了 上 面 的 示例 Slim 应 用 程序 中 的 “profile” 路 由 的 链接 URL ° 


{% extends "layout.html" %} 
{% block body %} 
<hi>User List</h1> 
<ul> 
<li><a href="{{ path_for('profile', { 'name': 'josh' }) }}">Josh</a></1li> 
</ul> 
{% endblock %} 


slim/php-view 组 件 


PHP-View PHP 组 件 帮助 你 泻 染 PHP 模版 。 该 组 件 可 以 在 Packagist 上 找到 ， 像 这 样 使 用 


人 


Composer %4 X : 


composer require slim/php-view 


Figure 4: Install slim/php-view component. 


在 Slim App 的 容器 中 ， 将 此 组 件 注册 为 服务 ， 这 么 做 : 


<?php 
// Create app $app = new \Slim\App(); 


// Get container $container = $app->getContainer(); 


// Register component on container $container['view'] = function ($container) { 
return new \Slim\Views\PhpRenderer('path/to/templates/with/trailing/slash/'); 
J; 


Figure 5: Register slim/php-view component with container. 


使 用 view 组 件 演 染 PHP 视图 : 


// Render Twig template in route 
$app->get('/hello/{name}', function ($request, $response, $args) { 
return $this->view->render($response, 'profile.html', [ 
"name' => $args['name' ] 
]); 
})->setName('profile'); 


// Run app 
$app->run(); 


Figure 6: Render template with slim/twig-view container service. 


其 他 模版 系统 


并 不 限于 使 用 Twig-view 和 pHP-View 组 件 。 你 可 以 使 用 任意 PHP 模版 系统 ， 只 要 它 能 演 
染 你 的 模版 ， 并 最 终 输 出 到 PSR7 响应 对 象 的 body 中 。 


HTTP 缓存 


Edit This Page 


Slim 3 使 用 slimphp/Slim-HttpCache 这 款 独立 的 PHP 组 件 作为 可 选 的 HTTP 缓存 工具 。 可 
以 使 用 这 个 组 件 创建 并 返回 包含 cache ，Expires ，ETag ,和 Last-Modified 头 的 HTTP 4 
应 ， 以 控制 何 时 以 及 如 何 使 用 客户 端 缓 咎 保留 应 用 程序 的 输出 。 


` J+ 


BOR 
在 你 的 项 目的 根 目 录 下 执行 这 个 bash 命 令 : 


composer require slim/http-cache 


用 法 


这 个 slimphp/Slim-HttpCache 组 件 包含 一 个 服 务 提供 程序 和 一 个 应 用 程序 中 间 件 。 你 必须 在 
你 的 应 用 程序 中 添加 这 两 个 玩意 ， 像 这 样 : 


// Register service provider with the container 
$container = new \Slim\Container; 
$container['cache'] = function () { 

return new \Slim\HttpCache\CacheProvider(); 


J; 

// Add middleware to the application 

$app = new \Slim\App($container); 

$app->add(new \Slim\HttpCache\Cache('public', 86400)); 


// Create your application routes... 


// Run application 
$app->run(); 


ETag 


使 用 服务 提供 程序 的 withEtag() 方法 创建 一 个 带 有 指定 ETag 头 的 响应 对 象 。 这 个 方法 接 
收 一 个 PSR7 响应 对 象 ， 而 且 它 返回 一 个 带 有 新 HTTP 头 的 PSR7 响应 的 拷贝 。 
$app->get('/foo', function ($req, $res, $args) { 
$reswWithEtag = $this->cache->withEtag($res, 'abc'); 


return $reswithEtag; 
3); 


Expires 


使 用 服务 提供 程序 的 withExpires() 方法 创建 一 个 带 有 指定 Expires 头 的 响应 对 象 。 这 个 方 
法 接收 一 个 PSR7 响应 对 象 ， 而 且 它 返回 一 个 带 有 新 的 HTTP AM PSR7 响应 的 拷贝 。 


$app->get('/bar',function ($req, $res, $args) { 
$reswWithExpires = $this->cache->withExpires($res, time() + 3600); 


return $resWithExpires; 


3); 


Last-Modified 


使 用 服务 提供 程序 的 withLastModified() 方法 创建 一 个 带 有 指定 Last-modified 头 的 响应 对 
象 。 这 个 方法 接收 一 个 PSR7 响应 对 象 ， 而 且 它 返回 一 个 带 有 新 HTTP KH) PSR7 响应 的 拷 
To 


//Example route with LastModified 
$app->get('/foobar', function ($req, $res, $args) { 
$resWithLastMod = $this->cache->withLastModified($res, time() - 3600); 


return $reswithLastMod; 
4); 


CSRF 保护 


Edit This Page 


Slim 3 使 用 独立 可 选 的 PHP 组 件 slimphp/Slim-Csrf 来 保护 应 用 程序 免 遭 CSRF ( 跨 站 请 求 
伪造 ) 。 本 组 件 为 每 个 请 求生 成 一 个 唯一 token ， 验 证 来 源 于 客户 端 HTML 表单 产生 的 
POST 请 求 。 


= 
BOR 
在 你 的 项 目的 根 目 录 下 执行 这 个 bash 命 令 : 


composer require slim/csrf 


用 法 


这 个 slimphp/Slim-csrf 组 件 包含 一 个 应 用 程序 中 间 件 。 像 这 样 将 它 添加 到 你 的 应 用 程序 
中 : 


// Add middleware to the application 
$app = new \Slim\App; 
$app->add(new \Slim\Csrf\Guard) ; 


// Create your application routes... 


// Run application 
$app->run(); 


提取 CSRF token 的 名 称 和 值 


最 新 的 CSRF token 作为 PSR7 请 求 对 象 的 属性 ， 其 名 称 和 值 是 可 获取 的 。 每 个 请 求 的 CSRF 
token 都 是 唯一 的 。 你 可 以 像 这 样 提 取 当 前 的 CSRF token 的 名 称 和 值 : 


$app->get('/foo', function ($req, $res, $args) { 
// Fetch CSRF token name and value 

$name = $req->getAttribute('csrf_name'); 

$value = $req->getAttribute('csrf_value'); 


// TODO: Render template with HTML form and CSRF token hidden field 
3); 


你 应 该 将 CSRF token 的 名 称 和 值 船体 给 模板 ， 这 样 它们 就 能 和 HTML 表单 POST 请 求 一 起 
被 提交 。 它 们 经 党 被 存储 为 HTML 表单 的 一 个 隐藏 字段 。 


Flash Messages 


Coming soon. 


